UI Customizations (Not in docs)

[laravellously]

Hello team 👋,

First of all, thanks for building nocto — the modular approach and developer-first mindset is exactly what we’ve been looking for in a Medusa admin.

I’ve been exploring the framework and trying to extend/customize it, but I’m currently stuck with:

1. Customizing the Auth pages

   • Is there an official way to override or extend these pages while still keeping the pluggable architecture intact?
   • Should we be working directly inside nocto or via a plugin/module layer?

2. Creating new custom pages, such as an Onboarding flow.

   • What’s the recommended way to register new routes and pages within nocto?
   • Is there a hook or config entry point for injecting custom React pages into the admin navigation?

I’ve checked the repo and docs but haven’t found clear guidance on these topics. A small example or starter template for:

• overriding an Auth page
• adding a new custom page

…would go a long way in helping teams build on top of nocto effectively.

Environment

• Nocto version: [latest]
• Medusa version: [v2]
• Node.js version: [v22]

Expected outcome:
Clear guidance (docs, examples, or patterns) for extending the Auth flow and adding new pages.

Thanks again for the project! Happy to contribute back once I get the hang of the extension points.

[radoslaw-sz]

hi @laravellously
Thank you for nice words! Let me go through your points:

Customizing the Auth pages
Which exactly pages do you have in mind? I am asking because right now there is a plugin in nocto called login (visible in nocto-config) which loads the login page based on the /login route. If you would like to change it then here are the solutions:

• overriding - you can totally override by removing @login plugin from nocto-config and add your own one with the proper route
• adding - you can add new routes with your own plugin and then such routes will load your implementation

Generally the routes: https://www.noctojs.com/docs/create-plugin/routes is your entry point for your use cases. You can totally write your own routes and implement what shall be under these routes, so you can add new pages.

Let me know if it explains, if not, then happy to help if you have some real, small example which you want to implement.

[vethan]

An example of what a route page should look like would be really helpful!