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. The Clinician Handbook is the primary plain-language path and is not wrapped in the authenticated app shell. | Public | Browse docs, use sidebar navigation, search, and follow related-page links | 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 |
/privacy, /terms, /legal/privacy, and /legal/terms | Public privacy and terms pages. | Public | Review current policy and terms content | Loaded content |
/acceptable-use, /subprocessors, and /vulnerability-disclosure | Public acceptable-use, provider, and security-reporting information. | Public | Review current boundaries and reporting routes | 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] | Public, read-only answer snapshot containing the shared question, answer, and citation labels. It does not grant access to project documents. | Anyone with a valid share link | Read the snapshot and visible citation labels | Loaded share, invalid share, expired or revoked 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 conversation in global or organization context. Some flows may preselect a project through route parameters. | Authenticated users with access | Ask a question, start a new conversation, choose context | Empty state, streaming answer, citation panel, error |
/chat/[conversationId] and organization-scoped conversation routes | Reopen and continue an existing conversation. Current conversation history is organization-scoped and should not be assumed private to its author. | Authenticated users in the permitted organization context | Continue the conversation, review citations, share, report, inspect prior answers | Loading, populated conversation, 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 |
/org/[orgId]/library and /org/[orgId]/library/[slug] | Organization-scoped Library and source-detail surfaces. | Authenticated users with relevant organization access | Search accessible sources, inspect metadata, briefings, and source detail | Empty, loading, populated, restricted |
/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 |
/chat/[conversationId]/report/[messageId] | Report an answer or message problem through the authenticated workflow. | Authenticated users with access to the conversation | Describe the issue without PHI, patient-specific facts, credentials, or secrets | Form, submitted, validation or request error |
| 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 |
/org/[orgId]/collections and /org/[orgId]/collections/[collectionId] | Optional source-collection list and detail pages. | Organization members or invited collection members, subject to collection visibility | Browse collections, inspect sources, and manage or query a collection when permitted | Empty, loading, populated, restricted |
| 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. | Authorized organization or project users; exact membership enforcement depends on workspace configuration | Review sources, upload files, inspect briefings, move into conversations or knowledge tools | Empty project, loading, populated, ingestion in progress |
/org/[orgId]/projects/[projectId]/settings | Project settings, governance, and access management. | Users with the required project or organization capability | Rename, archive, restore, or delete a project; manage access and review configuration when permitted | Loaded settings, restricted, validation error |
/org/[orgId]/chat/new?projectId={projectId} | Project-scoped conversation entry using the shared conversation surface. | Users allowed to access the selected project | Ask a question restricted to that project | Empty conversation, 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, question 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 | Legacy compatibility route that redirects a signed-in user to the active organization's project list. | Authenticated users | Continue to project setup | Loading handoff, redirect |
| URL pattern | What it does | Who can access it | Key actions available | Common states |
|---|
/org/admin/embedding-tuner | Admin-only tuning surface for source-review behavior. | Authorized admins | Upload evaluation source sets, inspect source-review 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?"