Reference
Page Reference
Route-level reference for the main public, workspace, and administrative pages in MARCUS.
This page is a practical route map for the current app. It focuses on pages that matter to real workflows and names the states a user is most likely to see.
Where a route is mainly a redirect, callback, or utility handoff, that is noted explicitly.
Each row tells you:
- the route pattern
- what the page is for
- who can normally access it
- the most important things a user can do there
- the states worth expecting during support, training, or debugging
| URL pattern | What it does | Who can access it | Key actions available | Common states |
|---|
/ | Marketing and product landing page for MARCUS. Introduces the product, primary workflows, pricing links, FAQ, and public navigation. | Public | Read overview, navigate to pricing, developers, login, signup, docs | Loaded marketing page, in-page section navigation |
/docs and /docs/* | Public documentation powered by MDX and Fumadocs. Not wrapped in the authenticated app shell. | Public | Browse docs, use sidebar navigation, use search, switch theme | Loaded docs page, not found page, search open |
/pricing | Public pricing and billing explainer surface. | Public | Review pricing plans, compare tiers, navigate toward signup | Loaded content |
/developers | Public engineering and benchmark-oriented page. | Public | Review developer-facing product and benchmark content | Loaded content |
/for-institutions | Public institutional-facing product page. | Public | Review institution-level positioning and navigation paths | Loaded content |
/security | Public security information page. | Public | Review security posture and trust-oriented content | Loaded content |
/legal/privacy and /legal/terms | Public legal pages. | Public | Review policy and terms content | Loaded content |
| URL pattern | What it does | Who can access it | Key actions available | Common states |
|---|
/login | Primary sign-in page. | Public | Enter credentials, use SSO if enabled, navigate to password recovery or signup | Form, validation error, loading, redirect on success |
/signup | Account creation flow. | Public | Create an account and begin organization access | Form, validation error, success transition |
/forgot-password | Password reset request page. | Public | Request reset instructions | Form, confirmation, error |
/verify-email, /verify-email/success, /verify-email/failure, /verify-email/error | Email verification entry and terminal states. | Public | Confirm email verification and understand failure or success outcome | Loading, success, error |
/invite/[token], /invites/[token], /join | Invitation acceptance and join flows. | Invited users or users following a valid invite | Accept invite, create account, join workspace | Valid token, invalid token, loading, success |
/sso/callback | Identity-provider callback handoff. | Public during auth handoff | Complete SSO sign-in and return to the app | Loading, success, auth failure |
| URL pattern | What it does | Who can access it | Key actions available | Common states |
|---|
/shared/[slug] | Shared-answer or shared-content page exposed through a dedicated share mechanism. | Anyone with a valid share slug, subject to sharing configuration | Read shared answer, inspect visible citations/context, move into login or signup if needed | Loaded share, invalid share, expired share |
| URL pattern | What it does | Who can access it | Key actions available | Common states |
|---|
/chat/new and /org/[orgId]/chat/new | Starts a new chat in global or organization context. Some flows may preselect a project through query parameters. | Authenticated users with access | Ask a question, start a new conversation, choose context | Empty state, streaming answer, citation panel, error |
/chat/[conversationId] and org-scoped conversation routes | Reopen and continue an existing conversation. | Authenticated users with access to that conversation and scope | Continue thread, review citations, share, report, inspect prior answers | Loading, populated thread, missing conversation |
/library | Cross-project Library surface for source discovery and document exploration. | Authenticated users with relevant access | Search, filter, switch views, inspect sources and briefings | Empty, loading, populated, filtered |
/bookmarks | Saved-item surface. | Authenticated users | Review saved items, open related content | Empty, populated |
/tasks | Task-management surface. | Authenticated users | Review or manage tasks depending on feature availability | Empty, populated |
/help | In-app help surface. | Authenticated users | Read help content, follow support-oriented links | Loaded help content |
| URL pattern | What it does | Who can access it | Key actions available | Common states |
|---|
/org/[orgId]/projects | Organization-scoped project index. | Authenticated members of the organization | Browse projects, open a project, create a project | Empty list, populated list, loading |
/org/[orgId]/projects/new | Project creation flow. | Users allowed to create projects in the organization | Create a project, define name and scope | Form, validation error, success redirect |
/projects | Redirect-style project entry surface in some flows. | Authenticated users | Redirect into org-scoped project list | Redirect or handoff |
/projects/new | Redirect-style project creation entry in some flows. | Authenticated users | Redirect into org-scoped project creation | Redirect or handoff |
| URL pattern | What it does | Who can access it | Key actions available | Common states |
|---|
/org/[orgId]/projects/[projectId] | Main project workspace. This is the anchor page for source management and project-level context. | Project members | Review sources, upload files, inspect briefings, move into chat or knowledge tools | Empty project, loading, populated, ingestion in progress |
/org/[orgId]/projects/[projectId]/settings | Project settings and membership management. | Project members with sufficient privileges | Rename project, manage members and invitations, review configuration | Loaded settings, validation error |
/org/[orgId]/chat/new?projectId={projectId} | Project-scoped chat entry using the shared chat surface. | Project members | Ask a question restricted to that project | Empty chat, streaming, answer visible |
| URL pattern | What it does | Who can access it | Key actions available | Common states |
|---|
/org/[orgId]/projects/[projectId]/knowledge | Project knowledge hub, including graph-oriented and project analysis views. | Project members | Inspect coverage, freshness, query patterns, and graph views | Loading, populated, empty or feature-limited |
/org/[orgId]/projects/[projectId]/knowledge/pages | Knowledge Pages index where that feature is enabled. | Project members | Browse generated knowledge pages, search pages, trigger generation where allowed | Empty, loading, populated |
/org/[orgId]/projects/[projectId]/knowledge/pages/[pageId] | Detail page for one knowledge page. | Project members | Read synthesized project-level knowledge, inspect related sources or metadata | Loading, populated, missing page |
/org/[orgId]/projects/[projectId]/themes/[analysisId] | Theme analysis review surface. | Project members | Inspect themes, rename, merge, split, accept, reject, and refine theme structure | Loading, populated analysis, error |
/org/[orgId]/projects/[projectId]/matrices/[matrixId] | Evidence matrix detail page. | Project members | Review side-by-side evidence, compare sources, edit matrix interpretation | Loading, populated matrix, generation state |
| URL pattern | What it does | Who can access it | Key actions available | Common states |
|---|
/analytics | Redirect or entry point into analytics for the current organization context. | Authorized users | Move into analytics view and inspect usage summaries | Redirect, loading, populated |
/org/[orgId]/analytics | Organization-level analytics view where configured. | Authorized users | Review usage patterns and adoption signals | Loading, populated |
/org/[orgId]/admin/costs | Administrative cost dashboard. | Authorized administrators | Inspect summaries, events, and time-series cost behavior | Loading, populated |
/developers | Public developer page, but it is also relevant for benchmark review. | Public | Review benchmark-oriented content and engineering-facing visibility | Loaded content |
| URL pattern | What it does | Who can access it | Key actions available | Common states |
|---|
/settings | Main settings area for the current user or workspace context. | Authenticated users | Review preferences, navigate to sub-sections | Loaded settings, validation error |
/settings/security | Security-oriented settings surface. | Authenticated users | Review session/security controls | Loaded settings |
/settings/billing | Billing-oriented settings surface. | Users with billing visibility | Review billing context and related settings | Loaded settings, restricted |
/settings/integrations | Integration settings surface. | Authenticated users or admins depending on the setting | Review connected integrations and related options | Loaded settings |
/onboarding | Guided first-run onboarding flow. | Newly created or redirected users | Define intent, create project, upload sources, complete onboarding | Multi-step flow, completion, skip or redirect paths |
| URL pattern | What it does | Who can access it | Key actions available | Common states |
|---|
/org/admin/embedding-tuner | Admin-only tuning surface for retrieval and embedding behavior. | Authorized admins | Upload evaluation corpora, inspect retrieval behavior | Loading, populated, upload states |
/org/admin/... | Additional admin or tuning routes. Exact visibility depends on deployment and feature flags. | Authorized admins | Inspect governance and operational tooling | Loading, restricted, populated |
Across the app, it is normal to encounter:
- loading skeletons while data is fetched
- empty states when a new project or workspace has no content yet
- not-found states for missing routes or removed resources
- restricted states when a user lacks membership or privileges
- error states when a request fails or a route callback is invalid
In support and training, a useful first question is not just "what page is this?" but also "which state of that page is the user actually in?"