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/*).
Important
This page describes the standard kit integration path; adapt app-specific paths and config names when your project differs.
How To Use
Essential config files in apps/dashboard/config
| File | Purpose |
|---|---|
app.config.ts | app name/title/description + email branding |
auth.config.ts | auth routes/providers/password rules |
i18n.config.ts | language resolver + namespaces |
analytics.config.ts | active analytics engines |
billing.config.ts | billing provider/products |
keybindings.config.ts | shortcut model |
settings.ui.config.tsx | settings 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.tslib/init-server-filters.tshooks/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
- Update the smallest relevant config file first.
- Ensure feature filters are initialized in both server and client paths when needed.
- 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.
Related
Quickstart
Fastest path from clone to running apps.
Filter API
Typed filter architecture used to compose kit features into apps with high modularity.
How is this guide?
Last updated on 3/23/2026