App Configuration

Codapult's behavior is controlled through a small set of TypeScript configuration files. These are the files you'll edit most when making the product your own.

App identity

Edit src/config/app.ts to set your product identity:

const appUrl = process.env.NEXT_PUBLIC_APP_URL ?? 'http://localhost:3000';

export const appConfig = {
  appUrl,
  serverUrl: process.env.VERCEL_URL ? `https://${process.env.VERCEL_URL}` : appUrl,
  appName: process.env.NEXT_PUBLIC_APP_NAME ?? 'my-app',
  brand: {
    name: 'My App',
    description: 'The best project management tool for teams',
    logo: '/logo.svg',
    showBuiltWithBadge: true,
    icons: {
      favicon: '/favicon.ico',
      svg: '/icon.svg',
      apple: '/apple-icon.png',
      pwa192: '/icon-192.png',
      pwa512: '/icon-512.png',
    },
  },
  // ...
};

The brand.name display name propagates to manifest.ts, layout.tsx metadata, and email templates automatically. The appUrl is used everywhere: robots.ts, sitemap.ts, auth callbacks, Stripe redirects, invite links, and email links. The serverUrl is used by tRPC for SSR data fetching — on Vercel preview deployments it points to the correct deployment URL instead of the production domain.

Feature toggles

All feature toggles live in environment variables (prefix ENABLE_*). They are surfaced server-side via env.features in src/lib/config.ts, and both the navigation and src/proxy.ts use the same source to hide UI and block routes.

All toggles default to true. Set the corresponding env var to false to disable the feature — its routes return 404 and its sidebar/footer entries disappear.

Each ENABLE_* flag is independent — disabling auth (AUTH_PROVIDER=none) does not cascade to other features. The only exception is twoFactor, which is meaningless without an auth provider and is therefore force-disabled when AUTH_PROVIDER=none. Dashboard-only modules (aiChat, teams, referrals, etc.) keep their flags but their pages live under /dashboard/*, which is itself 404 when auth is off; their public-facing parts (e.g. /feature-requests, /changelog) remain accessible until you flip the matching ENABLE_* flag (the CLI setup --preset marketing does this for you).

Auth configuration

Sign-in methods are controlled by environment variables:

Both are read via env.auth.magicLink and env.auth.passkeys in src/lib/config.ts.

OAuth providers appear automatically when both <PROVIDER>_CLIENT_ID and <PROVIDER>_CLIENT_SECRET env vars are set (supported: google, github, apple, discord, twitter, microsoft).

Two-factor authentication (TOTP) is controlled by ENABLE_TWO_FACTOR — see Feature toggles.

AI configuration

Customize the AI chat assistant behavior (src/config/app.ts):

ai: {
  defaultModel: 'gpt-4o-mini',
  systemPrompt: 'You are a helpful AI assistant. Be concise, accurate, and helpful.',
  ragEnabled: true,
  ragMaxChunks: 3,
  ragMinScore: 0.4,
  allowedModels: [],
},

Company links

Set company contact details used in the Privacy Policy, Terms of Service, and footer (src/config/app.ts):

company: {
  contactEmail: 'support@myapp.com',
  githubUrl: 'https://github.com/myorg/myapp',
},

Navigation

Edit src/config/navigation.ts to customize sidebar items for the dashboard and admin panel.

Each item has a href, label, icon (from Lucide), and an optional featureKey:

import type { env } from '@/lib/config';

export interface NavItem {
  href: string;
  label: string;
  icon: LucideIcon;
  featureKey?: keyof typeof env.features;
}

When featureKey is set, the item is automatically hidden if that feature is disabled in env.features (see the Feature toggles table).

Dashboard sidebar

export const dashboardNavItems: NavItem[] = [
  { href: '/dashboard', label: 'Dashboard', icon: LayoutDashboard },
  { href: '/dashboard/ai-chat', label: 'AI Chat', icon: MessageSquare, featureKey: 'aiChat' },
  { href: '/dashboard/analytics', label: 'Analytics', icon: BarChart3, featureKey: 'analytics' },
  { href: '/dashboard/billing', label: 'Billing', icon: CreditCard },
  // ...add your own items here
];

Admin sidebar

export const adminNavItems: NavItem[] = [
  { href: '/admin', label: 'Overview', icon: ShieldCheck },
  { href: '/admin/users', label: 'Users', icon: Users },
  { href: '/admin/subscriptions', label: 'Subscriptions', icon: CreditCard },
  { href: '/admin/feature-flags', label: 'Feature Flags', icon: Flag },
  // ...
];

To add a custom page, create the route in src/app/[locale]/(dashboard)/dashboard/your-page/page.tsx and add a corresponding entry to dashboardNavItems.

Marketing configuration

The shipped marketing routes describe Codapult. Replace them with your own product's claims, pricing, screenshots, legal copy, and docs before deploying a customer-facing SaaS.

Edit these files together:

If you do not need a surface at launch, disable it with the matching ENABLE_* env var where available and remove it from navigation, sitemap, and footer links.

Pricing tiers

export const pricingTiers: Record<TierKey, PricingTier> = {
  starter: {
    key: 'starter',
    ...getPriceInfo(49, 99),
    link: checkoutHref(env.checkout.starter, env.checkout.variants.starter, 'starter', '/sign-up'),
    featureKeys: ['tierFeatureProject1', 'tierFeatureUpdates6', 'tierFeatureCommunity'],
  },
  // ... pro (featured), enterprise
};

Feature labels are stored in messages/en.json under the "ProductPricing" namespace, so they support i18n. The key maps to a translation key for the tier name.

Set featured: true on a tier to visually highlight it. The link property is created by checkoutHref() in src/config/marketing-pricing.ts: variant IDs route through /api/checkout?product=<key>, direct checkout URLs open externally, and the fallback is /sign-up.

Premium plugins

Premium plugins are configured in the premiumPlugins record and pluginBundle object in src/config/marketing-pricing.ts. Each plugin has a link created from a direct checkout URL or a provider variant ID:

• CHECKOUT_URL_PLUGIN_AI_KIT — AI Kit plugin
• CHECKOUT_URL_PLUGIN_CRM — CRM plugin
• CHECKOUT_URL_PLUGIN_HELPDESK — Helpdesk plugin
• CHECKOUT_URL_PLUGIN_EMAIL_MARKETING — Email Marketing plugin
• CHECKOUT_URL_PLUGIN_BUNDLE — All plugins bundle (discounted)

When set, plugin cards on the pricing page and the /plugins page show purchase buttons. Without these env vars, buttons link to /#plugins.

Testimonials

export const testimonials: Testimonial[] = [
  {
    name: 'Alex Chen',
    role: 'Founder, StartupXYZ',
    content: 'Codapult saved me weeks of setup time.',
    initials: 'AC',
  },
  // ...add real customer quotes
];

Stats, modules, and comparison pages

The stats array powers the "by the numbers" section on the landing page. moduleCategories powers the module showcase. Comparison pages read from src/config/competitor-comparison.ts; edit or remove those entries so they match your product's real feature matrix and competitors.

Typed env var access

src/lib/config.ts provides a typed env object for reading environment variables in server code:

import { env } from '@/lib/config';

// Type-safe access with defaults
env.auth.provider; // 'better-auth' | 'kinde' | 'none'
env.paymentProvider; // 'stripe' | 'lemonsqueezy'
env.storageProvider; // 'local' | 's3' | 'r2'
env.notificationTransport; // 'poll' | 'sse' | 'ws'
env.vectorStoreProvider; // 'sqlite' | 'memory'
env.sso.product; // string — SSO product identifier
env.defaultMonthlyCredits; // number — monthly AI credits
env.stripe.connectFeePercent; // number — Stripe Connect fee
env.stripe.secretKey; // string
env.turso.url; // string

Important: Server-side code should use env.* for adapter/provider settings and appConfig.* for app identity (appUrl, serverUrl, appName, brand). Never read process.env directly for values available through these objects.

This file is hand-maintained. When adding a new environment variable, add a Zod field to the schema and a corresponding property to the env object in the same file.

For the full list of environment variables and their descriptions, see the Environment Variables reference.