Get Started
PreviousNext

Configuration

Core config files that control behavior across the web apps.

What It Does

Configuration files define routes, auth behavior, i18n, analytics, billing, settings UI, and app identity.

When To Use

  • Bootstrapping a new app.
  • Switching providers (billing, analytics, email).
  • Adding/removing feature modules.

Prerequisites

  • Understand app-level config location (apps/<app>/config/*).

How To Use

Essential config files in apps/dashboard/config

FilePurpose
app.config.tsapp name/title/description + email branding
auth.config.tsauth routes/providers/password rules
i18n.config.tslanguage resolver + namespaces
analytics.config.tsactive analytics engines
billing.config.tsbilling provider/products
keybindings.config.tsshortcut model
settings.ui.config.tsxsettings page composition

Shared config package

@kit/shared/config/* (source in packages/shared/src/config/*) provides route constants, default languages, and shared settings schema.

Filters initialization

Keep these files synchronized with enabled features:

  • lib/init-cross-env-filters.ts
  • lib/init-server-filters.ts
  • hooks/use-filters.ts

MCP Context

capability: app_configuration
entrypoints:
  - apps/dashboard/config/
  - apps/dashboard/lib/init-*.ts
  - apps/dashboard/hooks/use-filters.ts
  - packages/shared/src/config/
inputs:
  - desired_feature_behavior
outputs:
  - updated_app_runtime_configuration
constraints:
  - config and filters must stay consistent
  - shared routes/languages should be imported from @kit/shared
side_effects:
  - changes runtime behavior across auth/settings/billing/etc.

Agent Recipe

  1. Update the smallest relevant config file first.
  2. Ensure feature filters are initialized in both server and client paths when needed.
  3. Validate by loading impacted routes and UI sections.

Troubleshooting

  • If UI appears but data is missing, verify server filter registration.
  • If translations are missing, verify namespace list and resolver wiring.

How is this guide?

Last updated on 3/23/2026