What It Does
The repository separates runtime apps from reusable feature kits and shared configuration packages.
When To Use
- You need to locate the correct ownership boundary before editing code.
- You are adding a feature and must decide app-level vs shared-level changes.
Prerequisites
- Basic Turborepo/pnpm workspace familiarity.
Important
This page describes the standard kit integration path; adapt app-specific paths and config names when your project differs.
How To Use
Use this mapping to decide where code should live.
Monorepo Snapshot
package.json
turbo.json
| Area | Purpose |
|---|---|
apps/* | Product entrypoints (dashboard, marketing, mobile, api, docs site) |
kit/* | Reusable business capabilities (auth, settings, org, billing, etc.) |
packages/shared | App-shared config and glue (@kit/shared) |
supabase/* | Database schemas, generated app schemas, migrations, SQL tests |
cli/* | Project generation and feature-pruning automation |
Package Snapshot
package.json
Typical implementation flow:
- Define shared schema/config in
packages/sharedor app config. - Register filters in app
lib/init-server-filters.ts/init-cross-env-filters.ts. - Consume functionality in app routes/components.
MCP Context
capability: repo_navigation entrypoints: - apps/ - kit/ - packages/shared/ - supabase/ - cli/ inputs: - feature_request outputs: - target_edit_locations constraints: - prefer kit reuse over app duplication - keep app-level code focused on composition/configuration side_effects: - none
Agent Recipe
- Identify which runtime app is affected.
- Check whether a
kit/*module already owns the behavior. - Apply changes in the shared layer first, then app integration points.
Troubleshooting
- If an import path starts with
@kit/shared/*, source files live underpackages/shared/src/*. - If a feature works in one app and not another, compare filter initialization files.
Related
MCP Server
Installable bridge that lets coding agents query Creatorem docs capabilities and page content.
Captcha
Protect server actions and forms with captcha verification.
How is this guide?
Last updated on 3/23/2026