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.

Brand configuration

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

export const appConfig: AppConfig = {
  brand: {
    name: 'MyApp',
    description: 'The best project management tool for teams',
    logo: '/logo.svg',
    favicon: '/favicon.ico',
    url: 'https://myapp.com',
    supportEmail: '[email protected]',
  },
  // ...
};

These values are used in the sidebar, email templates, SEO meta tags, and OG images throughout the app.

Feature toggles

The features object controls which modules are active. Set any toggle to false to disable a feature — it will be hidden from the navigation, and its routes become inaccessible.

features: {
  aiChat: true,
  teams: true,
  blog: true,
  helpCenter: true,
  waitlist: true,
  referrals: true,
  analytics: true,
  workflows: true,
  webhooks: true,
  auditLog: true,
  reports: true,
  featureRequests: true,
  changelog: true,
  onboarding: true,
  branding: true,
  sso: true,
  experiments: true,
  dripCampaigns: true,
},

All 18 toggles are true by default. Here's what each one controls:

Navigation items are automatically hidden when their linked feature is disabled — no manual sidebar editing needed.

Auth configuration

Control which sign-in methods appear on the auth pages:

auth: {
  oauthProviders: ['google', 'github'],
  magicLink: true,
  passkeys: true,
  twoFactor: true,
},

You still need to configure the corresponding environment variables (e.g. GOOGLE_CLIENT_ID) for OAuth providers to function.

AI configuration

Customize the AI chat assistant behavior:

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: [],
},

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 { FeaturesConfig } from './app';

export interface NavItem {
  href: string;
  label: string;
  icon: LucideIcon;
  featureKey?: keyof FeaturesConfig;
}

When featureKey is set, the item is automatically hidden if that feature is disabled in appConfig.features.

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: LayoutDashboard },
  { 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/(dashboard)/dashboard/your-page/page.tsx and add a corresponding entry to dashboardNavItems.

Marketing configuration

Edit src/config/marketing.ts to customize the landing page content.

Pricing tiers

export const pricingTiers: PricingTier[] = [
  {
    key: 'starter',
    price: '$49',
    featureKeys: ['tierFeatureFullCode', 'tierFeatureAllModules', 'tierFeatureProject1'],
  },
  {
    key: 'pro',
    price: '$99',
    featured: true,
    featureKeys: ['tierFeatureFullCode', 'tierFeatureAllModules', 'tierFeatureProject3'],
  },
  {
    key: 'enterprise',
    price: '$149',
    featureKeys: ['tierFeatureFullCode', 'tierFeatureAllModules', 'tierFeatureProjectUnlimited'],
  },
];

Feature labels are stored in messages/en.json under the "Pricing" 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. Use the optional href property to link to an external checkout (e.g. LemonSqueezy or Gumroad).

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 and competitor comparison

The stats array powers the "by the numbers" section on the landing page. The comparisonFeatures array generates the competitor comparison table — edit it to reflect your product's feature matrix.

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.authProvider; // 'better-auth' | 'kinde'
env.paymentProvider; // 'stripe' | 'lemonsqueezy'
env.turso.url; // string
env.stripe.secretKey; // string
env.notificationTransport; // 'poll' | 'sse' | 'ws'

This file is auto-generated based on .env.example. You don't need to edit it unless you add a new environment variable — in that case, add a corresponding entry to the env object.

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