Route Reference
High-Level Application Flow
- Visitor lands on the public marketplace home page:
/ - Visitor browses categories, listing search results, listing detail pages, seller profiles, pricing, and CMS pages
- Visitor signs up or logs in through landing auth routes
- Authenticated users are sent to the dashboard
- Dashboard root redirects to
/dashboard - Seller roles manage listings, watchlist, invoices, profile, messages, promotions, and support pages
- Super Admin additionally gets moderation, users, categories, content management, subscription plans, promotion packages, and payment invoice modules
Route Guard Rules
| Route Type | Behavior |
|---|---|
| Dashboard app routes | Require authentication; guests are redirected to sign-in / landing auth flow |
| Dashboard auth routes | If already authenticated, redirect to /dashboard |
| Shared routes | Render under authenticated dashboard layout or guest layout depending on session state |
| Landing routes | Public Next.js pages; auth forms call backend SPA/API auth endpoints |
| Backend protected API | Uses Sanctum/session auth; super-admin APIs additionally enforce super-admin role |
Landing Website Routes
| Module / Section | URL Route | Purpose |
|---|---|---|
| Home / Marketplace | / | Public landing home page with hero, categories, promoted/latest listings, and marketing sections |
| Categories | /categories/[...slugs] | Dynamic category hierarchy and nested browsing |
| Listings Browse | /listing | Main listing gallery/search page |
| Listings Browse Redirect | /listing/listings | Legacy/alternate listing URL redirecting to /listing |
| Category Listings | /listing/category/[slug] | Listings filtered by category |
| Listing Detail | /listing/[id] | Public listing detail page |
| Seller Profile | /seller/[id] | Public seller/business profile |
| Pricing | /pricing | Public subscription pricing page |
| Listing Pricing | /listing/prices | Listing-side pricing/subscription view |
| Checkout | /checkout | Checkout / payment-start page |
| Payment Success | /payment-success | Payment success return page |
| Payment Failed | /payment-failed | Payment failure / cancel page |
| Login | /login | Public login form |
| Signup | /signup | Pricing-aware signup flow |
| Forgot Password | /forgot-password | Password reset request |
| Reset Password | /reset-password | Password reset form |
| Static Pages Index | /pages | CMS/static page index |
| Static Page Detail | /pages/[slug] | CMS-managed static page detail |
| Payment Methods | /listing/payment-methods | Payment-method information page |
| Terms | /listing/terms-and-conditions | Terms and conditions page |
| API Health | /api/health | Next.js health-check endpoint |
Dashboard Seller Routes
| Module / Section | URL Route | Purpose |
|---|---|---|
| Root Redirect | / | Redirects to /dashboard |
| Dashboard | /dashboard | Main role dashboard summary |
| Listing Management | /listings | User listing table |
| Listing Grid | /listings/grid | Grid version of user listings |
| Create Listing | /listings/new | New listing form |
| Listing Detail | /listings/:listingId | Listing detail preview in dashboard |
| Edit Listing | /listings/:listingId/edit | Edit listing form |
| Promote Listing | /listings/:listingId/promote | Promotion purchase/manage page |
| Promotion History | /listings/promotions | User promotion history |
| Watchlist | /watchlist | Saved listings |
| Profile | /profile | User profile overview |
| Edit Profile | /profile/edit | Personal profile edit |
| Edit Business Profile | /profile/business/edit | Business profile edit |
| Invoices | /invoices | User invoices |
| Messages | /apps/chat | Listing/user conversations |
| Pricing Redirect | /pages/pricing | Redirect/bridge to landing pricing page |
| FAQs / Help | /support/faqs | Support page |
| Payment Success Redirect | /payment-success | Redirects to landing payment success page |
| Payment Failed Redirect | /payment-failed | Redirects to landing payment failed page |
Dashboard Auth / Utility Routes
| URL Route | Behavior |
|---|---|
/sign-in | Legacy route redirecting to landing login |
/sign-up | Legacy route redirecting to landing signup |
/auth/reset-password | Dashboard reset-password utility page |
/auth/lock-screen | Lock-screen page |
/pages-404 | Not-found page |
/maintenance | Maintenance page |
/coming-soon | Coming-soon page |
* | Catch-all 404 |
Super Admin Routes
| Module / Section | URL Route | Purpose |
|---|---|---|
| Moderation | /admin/listings | Review and moderate platform listings |
| Moderation | /admin/reports | Review user/listing reports |
| User Management | /admin/users | User list and management |
| User Detail | /admin/users/:id | User detail page |
| Email Notifications | /admin/email-notification-settings | Platform email notification settings |
| Payments | /admin/payment-invoices | Admin payment invoice monitoring |
| Subscription Plans | /admin/subscription-plans | Subscription plan list |
| Subscription Plans | /admin/subscription-plans/create | Create plan |
| Subscription Plans | /admin/subscription-plans/:id/edit | Edit plan |
| Promotion Packages | /admin/promotion-packages | Promotion package list |
| Promotion Packages | /admin/promotion-packages/create | Create promotion package |
| Promotion Packages | /admin/promotion-packages/:id/edit | Edit promotion package |
| Promotion Monitoring | /admin/promotions | Monitor listing promotions |
| Content Management | /admin/content | Content admin landing route |
| Header Content | /admin/content/header | Edit landing hero/header content |
| Shop Categories | /admin/content/shop-categories | Edit landing category tiles |
| Sidebar CTA | /admin/content/sidebar-cta | Edit dashboard/sidebar CTA content |
| Announcement Modal | /admin/content/announcement-modal | Edit landing popup content |
| Footer Content | /admin/content/footer | Edit footer sections/topics/branding/static pages |
| New Footer Page | /admin/content/footer/pages/new | Create footer/static CMS page |
| Edit Footer Page | /admin/content/footer/pages/:topicId/edit | Edit footer/static CMS page |
| Content Menu | /admin/content/menu | Content menu route |
| Category List | /category/category-list | Category list |
| Category Create | /category/category-add | Create category |
| Category Edit | /category/category-edit/:categoryId | Edit category |
Legacy Redirects
| Old Route | New Route | Reason |
|---|---|---|
/products/product-list | /listings | Old product naming replaced by listings |
/products/product-grid | /listings/grid | Grid route preserved for bookmarks |
/products/product-add | /listings/new | Old create route preserved |
/products/promotions | /listings/promotions | Old promotion history route preserved |
/products/:productId/edit | /listings/:productId/edit | Old edit route preserved |
/products/:productId/promote | /listings/:productId/promote | Old promote route preserved |
/products/:productId | /listings/:productId | Old detail route preserved |
/sign-in | {landing}/login | Dashboard auth delegated to landing |
/sign-up | {landing}/signup | Dashboard auth delegated to landing |
/pages/pricing | {landing}/pricing | Pricing lives on landing |
/payment-success | {landing}/payment-success | Payment return page lives on landing |
/payment-failed | {landing}/payment-failed | Payment return page lives on landing |
Backend/API Grouping Summary
Observed or referenced API groups align with:- session identity and auth
- listings and listing attributes
- watchlist
- chat threads
- notifications
- subscriptions and invoices
- promotions
- admin moderation/users/content/categories/subscriptions
Visual Route Examples
Landing routes
Seller routes
Admin routes
