Module Architecture

Design Principles

Every feature in Codapult is packaged as a self-contained module with its own directories, routes, components, and database tables. Modules follow three rules:

1. Independent — each module lives in its own directories and can be deleted without breaking other modules.
2. Core-dependent only — modules depend on the Core layer (Auth, Database, Rate Limiting, Validation), not on each other, unless explicitly noted.
3. CLI-removable — the interactive setup wizard can strip modules automatically.

Module Map

| Module | Directories | Dependencies | Removable | | ---------------------- | ------------------------------------------------------------------------------------- | ----------------- | --------- | | Auth | src/lib/auth/, src/app/(auth)/ | Core (required) | No | | Database | src/lib/db/ | Core (required) | No | | AI Chat | src/app/(dashboard)/dashboard/ai-chat/, src/app/api/chat/, src/components/ai/ | None | Yes | | Billing | src/lib/payments/, src/lib/actions/billing.ts, src/app/api/webhooks/ | None | Yes | | Blog | src/app/(marketing)/blog/, src/components/blog/, src/lib/blog/, content/blog/ | None | Yes | | Teams | src/app/(dashboard)/dashboard/teams/, src/app/invite/ | Auth | Yes | | Notifications | src/lib/notifications.ts, src/components/dashboard/NotificationBell.tsx | Auth | Yes | | Feature Flags | src/lib/feature-flags.ts, src/app/admin/feature-flags/ | DB | Yes | | File Uploads | src/lib/storage/, src/app/api/upload/ | Auth | Yes | | Waitlist | src/app/(marketing)/waitlist/ | Email | Yes | | API Keys | src/lib/api-keys.ts | Auth, DB | Yes | | Usage Credits | src/lib/usage.ts | Auth, DB | Yes | | Activity Log | src/lib/activity-log.ts, src/app/admin/activity/ | DB | Yes | | Webhook Log | src/lib/webhook-log.ts, src/app/admin/webhooks/ | DB | Yes | | Support Widget | src/components/support/SupportWidget.tsx | None | Yes | | Email | src/lib/email/ | Resend | Yes | | i18n | src/i18n/, messages/ | next-intl | Yes | | Analytics (PostHog) | src/components/analytics/ | PostHog | Yes | | SEO | src/app/sitemap.ts, src/app/robots.ts | None | Yes | | Sentry | src/instrumentation*.ts, src/sentry.*.ts | @sentry/nextjs | Yes | | GraphQL API | src/lib/graphql/, src/app/api/graphql/ | graphql-yoga | Yes | | Enterprise SSO | src/lib/sso/ | None | Yes | | Help Center | src/lib/docs/, src/app/(marketing)/docs/help/, content/docs/ | None | Yes | | A/B Testing | src/lib/experiments/ | DB | Yes | | Feature Requests | src/lib/feature-requests/ | DB | Yes | | Stripe Connect | src/lib/payments/connect.ts | Stripe | Yes | | Event Store | src/lib/event-store/ | DB | Yes | | White-labeling | src/lib/white-label/ | DB | Yes | | GDPR | src/lib/gdpr/ | DB | Yes | | Outgoing Webhooks | src/lib/outgoing-webhooks/ | DB | Yes | | Drip Campaigns | src/lib/drip-campaigns/ | Email, Jobs | Yes | | Onboarding Tours | src/lib/onboarding/ | DB | Yes | | Analytics (Self-serve) | src/lib/analytics/ | DB | Yes | | Custom Domains | src/lib/custom-domains/ | DB | Yes | | Workflows | src/lib/workflows/ | Email | Yes | | Referrals | src/lib/referrals/ | DB | Yes | | OpenTelemetry | src/lib/telemetry/ | @opentelemetry/* | Yes | | Changelog Widget | src/components/dashboard/ChangelogWidget.tsx | None | Yes | | RAG Pipeline | src/lib/ai/rag.ts, src/lib/ai/embeddings.ts | @ai-sdk/openai | Yes | | SCIM Provisioning | src/lib/scim/ | Teams | Yes | | Chat Memory | src/lib/ai/conversations.ts | AI Chat, DB | Yes | | Scheduled Reports | src/lib/scheduled-reports/ | Email, Jobs | Yes | | API Versioning | src/lib/api-version.ts | None | Yes | | Audit Log (User) | src/app/api/audit-log/ | Activity Log | Yes |

How to Remove a Module

CLI Wizard (Recommended)

Run the interactive setup wizard and deselect the modules you don't need:

npx @codapult/cli setup

The wizard automatically deletes files, removes imports, cleans up navigation, and updates the schema.

Manual Removal

For finer control, remove a module by hand:

1. Delete the module's directories (see the table above).
2. Remove all imports referencing the deleted module.
3. Remove database tables from src/lib/db/schema.ts and regenerate migrations.
4. Remove navigation links from Sidebar.tsx, admin layout, and marketing navbar.
5. Uninstall npm dependencies unique to the module.
6. Remove environment variables from .env.example.

Example: Removing AI Chat

# Delete files
rm -rf src/app/\(dashboard\)/dashboard/ai-chat
rm -rf src/app/api/chat
rm -rf src/components/ai

# Remove the AI Chat nav item from Sidebar.tsx
# Edit src/components/dashboard/Sidebar.tsx

# Uninstall dependencies (if not used elsewhere)
pnpm remove @ai-sdk/openai @ai-sdk/anthropic ai @ai-sdk/react

# Remove env vars from .env.example:
# OPENAI_API_KEY, ANTHROPIC_API_KEY, EMBEDDING_PROVIDER,
# VECTOR_STORE_PROVIDER, OLLAMA_BASE_URL, OLLAMA_EMBEDDING_MODEL

Example: Removing Teams

# Delete files
rm -rf src/app/\(dashboard\)/dashboard/teams
rm -rf src/app/invite
rm src/components/dashboard/TeamSwitcher.tsx
rm src/components/dashboard/TeamSettings.tsx
rm src/components/dashboard/AcceptInvitationButton.tsx
rm src/lib/db/organizations.ts
rm src/lib/actions/organizations.ts

# Remove organization tables from src/lib/db/schema.ts:
# organization, organization_member, organization_invitation

# Remove TeamSwitcher from Sidebar.tsx

# Regenerate migrations
pnpm run db:generate

Dependency Boundaries

Modules form a layered dependency graph. The Core layer is required; everything above it is optional and independently removable.

┌─────────────────────────────────────────────────┐
│                    Core Layer                    │
│  (Auth, Database, Rate Limiting, Validation)    │
└──────────────────────┬──────────────────────────┘
                       │
         ┌─────────────┼─────────────┐
         │             │             │
    ┌────▼────┐  ┌────▼────┐  ┌────▼────┐
    │ Billing │  │  Teams  │  │  Admin  │
    └─────────┘  └─────────┘  └─────────┘
         │             │             │
    ┌────▼────┐  ┌────▼────┐  ┌────▼────┐
    │ Usage   │  │  RBAC   │  │ Feature │
    │ Credits │  │         │  │  Flags  │
    └─────────┘  └─────────┘  └─────────┘

Modules only depend on the Core layer. They do not depend on each other unless explicitly noted in the Dependencies column (for example, SCIM Provisioning depends on Teams, and Chat Memory depends on AI Chat).