create-skit 0.1.0

package/lib/module-application.mjs

@@ -0,0 +1,281 @@
+import { readFile } from "node:fs/promises";
+import path from "node:path";
+
+async function readJson(filePath) {
+  const content = await readFile(filePath, "utf8");
+  return JSON.parse(content);
+}
+
+async function loadModule(repoRoot, moduleName) {
+  const modulePath = path.join(repoRoot, "modules", moduleName, "module.json");
+  return readJson(modulePath);
+}
+
+function getBillingProviderFromDefinitions(moduleDefinitions) {
+  const providers = new Set();
+
+  for (const moduleDefinition of moduleDefinitions) {
+    for (const provider of moduleDefinition.template?.billingProviders ?? []) {
+      providers.add(provider);
+    }
+  }
+
+  if (providers.has("stripe") && providers.has("polar")) {
+    return "both";
+  }
+
+  if (providers.has("stripe")) {
+    return "stripe";
+  }
+
+  if (providers.has("polar")) {
+    return "polar";
+  }
+
+  return "none";
+}
+
+function getEmailProviderFromDefinitions(moduleDefinitions) {
+  for (const moduleDefinition of moduleDefinitions) {
+    if (moduleDefinition.template?.emailProvider) {
+      return moduleDefinition.template.emailProvider;
+    }
+  }
+
+  return "none";
+}
+
+function getPackageDependenciesFromDefinitions(moduleDefinitions) {
+  const dependencyLines = [];
+
+  for (const moduleDefinition of moduleDefinitions) {
+    dependencyLines.push(...(moduleDefinition.template?.packageDependencies ?? []));
+  }
+
+  return dependencyLines.join("\n");
+}
+
+function getBillingImportsFromDefinitions(moduleDefinitions) {
+  const lines = [];
+
+  for (const moduleDefinition of moduleDefinitions) {
+    lines.push(...(moduleDefinition.template?.billing?.imports ?? []));
+  }
+
+  return lines.join("\n");
+}
+
+function getBillingFactoriesFromDefinitions(moduleDefinitions) {
+  const lines = [];
+
+  for (const moduleDefinition of moduleDefinitions) {
+    lines.push(...(moduleDefinition.template?.billing?.factories ?? []));
+  }
+
+  return lines.join("\n");
+}
+
+function getStripeWebhookRouteBody(moduleDefinitions) {
+  for (const moduleDefinition of moduleDefinitions) {
+    if (moduleDefinition.template?.billing?.stripeWebhookRouteBody) {
+      return moduleDefinition.template.billing.stripeWebhookRouteBody;
+    }
+  }
+
+  return "  return new Response(\"Stripe billing is not enabled for this project.\", { status: 404 });";
+}
+
+function getPolarWebhookRouteBody(moduleDefinitions) {
+  for (const moduleDefinition of moduleDefinitions) {
+    if (moduleDefinition.template?.billing?.polarWebhookRouteBody) {
+      return moduleDefinition.template.billing.polarWebhookRouteBody;
+    }
+  }
+
+  return "  return new Response(\"Polar billing is not enabled for this project.\", { status: 404 });";
+}
+
+function getStripeWebhookRouteImport(moduleDefinitions) {
+  for (const moduleDefinition of moduleDefinitions) {
+    if (moduleDefinition.template?.billing?.stripeWebhookRouteBody) {
+      return 'import { getBillingProvider } from "@/lib/billing";';
+    }
+  }
+
+  return "";
+}
+
+function getStripeWebhookRouteSignature(moduleDefinitions) {
+  for (const moduleDefinition of moduleDefinitions) {
+    if (moduleDefinition.template?.billing?.stripeWebhookRouteBody) {
+      return "request: Request";
+    }
+  }
+
+  return "_request: Request";
+}
+
+function getPolarWebhookRouteImport(moduleDefinitions) {
+  for (const moduleDefinition of moduleDefinitions) {
+    if (moduleDefinition.template?.billing?.polarWebhookRouteBody) {
+      return 'import { getBillingProvider } from "@/lib/billing";';
+    }
+  }
+
+  return "";
+}
+
+function getPolarWebhookRouteSignature(moduleDefinitions) {
+  for (const moduleDefinition of moduleDefinitions) {
+    if (moduleDefinition.template?.billing?.polarWebhookRouteBody) {
+      return "request: Request";
+    }
+  }
+
+  return "_request: Request";
+}
+
+function getEmailImportsFromDefinitions(moduleDefinitions) {
+  const lines = [];
+
+  for (const moduleDefinition of moduleDefinitions) {
+    lines.push(...(moduleDefinition.template?.email?.imports ?? []));
+  }
+
+  return lines.join("\n");
+}
+
+function getEmailEnvImport(moduleDefinitions) {
+  for (const moduleDefinition of moduleDefinitions) {
+    if (moduleDefinition.template?.email?.setup) {
+      return 'import { env } from "@/lib/env";';
+    }
+  }
+
+  return "";
+}
+
+function getEmailSetupFromDefinitions(moduleDefinitions) {
+  for (const moduleDefinition of moduleDefinitions) {
+    if (moduleDefinition.template?.email?.setup) {
+      return moduleDefinition.template.email.setup;
+    }
+  }
+
+  return "";
+}
+
+function getEmailFromAddressHelper(moduleDefinitions) {
+  for (const moduleDefinition of moduleDefinitions) {
+    if (moduleDefinition.template?.email?.setup) {
+      return `function getFromAddress() {
+  if (!env.EMAIL_FROM) {
+    throw new Error("EMAIL_FROM is required for email sending.");
+  }
+
+  return env.EMAIL_FROM;
+}`;
+    }
+  }
+
+  return "";
+}
+
+function getEmailSendImplementation(moduleDefinitions) {
+  for (const moduleDefinition of moduleDefinitions) {
+    if (moduleDefinition.template?.email?.sendImplementation) {
+      return moduleDefinition.template.email.sendImplementation;
+    }
+  }
+
+  return '  return { skipped: true as const, provider: "none" as const };';
+}
+
+function getEmailSendSignature(moduleDefinitions) {
+  for (const moduleDefinition of moduleDefinitions) {
+    if (moduleDefinition.template?.email?.sendImplementation) {
+      return "input";
+    }
+  }
+
+  return "_input";
+}
+
+export async function buildModuleTokenReplacements(repoRoot, scaffoldPlan) {
+  const replacements = {};
+  const moduleDefinitions = [];
+
+  for (const moduleName of scaffoldPlan.modules) {
+    const moduleDefinition = await loadModule(repoRoot, moduleName);
+    moduleDefinitions.push(moduleDefinition);
+
+    for (const [token, value] of Object.entries(
+      moduleDefinition.template?.tokenReplacements ?? {}
+    )) {
+      replacements[token] = value;
+    }
+  }
+
+  replacements.__BILLING_PROVIDER__ = getBillingProviderFromDefinitions(moduleDefinitions);
+  replacements.__EMAIL_PROVIDER__ = getEmailProviderFromDefinitions(moduleDefinitions);
+  replacements.__PROVIDER_PACKAGE_DEPENDENCIES__ =
+    getPackageDependenciesFromDefinitions(moduleDefinitions);
+  replacements.__BILLING_PROVIDER_IMPORTS__ = getBillingImportsFromDefinitions(moduleDefinitions);
+  replacements.__BILLING_PROVIDER_FACTORIES__ =
+    getBillingFactoriesFromDefinitions(moduleDefinitions);
+  replacements.__STRIPE_WEBHOOK_ROUTE_IMPORT__ =
+    getStripeWebhookRouteImport(moduleDefinitions);
+  replacements.__STRIPE_WEBHOOK_ROUTE_SIGNATURE__ =
+    getStripeWebhookRouteSignature(moduleDefinitions);
+  replacements.__STRIPE_WEBHOOK_ROUTE_BODY__ =
+    getStripeWebhookRouteBody(moduleDefinitions);
+  replacements.__POLAR_WEBHOOK_ROUTE_IMPORT__ =
+    getPolarWebhookRouteImport(moduleDefinitions);
+  replacements.__POLAR_WEBHOOK_ROUTE_SIGNATURE__ =
+    getPolarWebhookRouteSignature(moduleDefinitions);
+  replacements.__POLAR_WEBHOOK_ROUTE_BODY__ = getPolarWebhookRouteBody(moduleDefinitions);
+  replacements.__EMAIL_PROVIDER_IMPORTS__ = getEmailImportsFromDefinitions(moduleDefinitions);
+  replacements.__EMAIL_ENV_IMPORT__ = getEmailEnvImport(moduleDefinitions);
+  replacements.__EMAIL_PROVIDER_SETUP__ = getEmailSetupFromDefinitions(moduleDefinitions);
+  replacements.__EMAIL_FROM_ADDRESS_HELPER__ =
+    getEmailFromAddressHelper(moduleDefinitions);
+  replacements.__EMAIL_SEND_SIGNATURE__ = getEmailSendSignature(moduleDefinitions);
+  replacements.__EMAIL_SEND_IMPLEMENTATION__ =
+    getEmailSendImplementation(moduleDefinitions);
+
+  return replacements;
+}
+
+export async function buildModuleFileOverlays(repoRoot, scaffoldPlan) {
+  const overlays = [];
+
+  for (const moduleName of scaffoldPlan.modules) {
+    const moduleDefinition = await loadModule(repoRoot, moduleName);
+
+    for (const relativeFilePath of moduleDefinition.template?.copyFiles ?? []) {
+      overlays.push({
+        source: path.join(repoRoot, "modules", moduleName, "files", relativeFilePath),
+        destination: relativeFilePath
+      });
+    }
+  }
+
+  return overlays;
+}
+
+export function buildModulePruneList(scaffoldPlan) {
+  const filesToRemove = [];
+  const moduleSet = new Set(scaffoldPlan.modules);
+
+  if (!moduleSet.has("billing-stripe")) {
+    filesToRemove.push("src/lib/billing/providers/stripe.ts");
+    filesToRemove.push("src/app/api/webhooks/stripe/route.ts");
+  }
+
+  if (!moduleSet.has("billing-polar")) {
+    filesToRemove.push("src/lib/billing/providers/polar.ts");
+    filesToRemove.push("src/app/api/webhooks/polar/route.ts");
+  }
+
+  return filesToRemove;
+}

package/lib/module-resolver.mjs

@@ -0,0 +1,179 @@
+import { readFile } from "node:fs/promises";
+import path from "node:path";
+
+async function readJson(filePath) {
+  const content = await readFile(filePath, "utf8");
+  return JSON.parse(content);
+}
+
+async function loadPreset(repoRoot, presetName) {
+  const presetPath = path.join(repoRoot, "presets", `${presetName}.json`);
+  return readJson(presetPath);
+}
+
+async function loadModule(repoRoot, moduleName) {
+  const modulePath = path.join(repoRoot, "modules", moduleName, "module.json");
+  return readJson(modulePath);
+}
+
+function mapDatabaseModule(databaseDriver) {
+  return databaseDriver === "postgres.js" ? "db-postgresjs" : "db-pg";
+}
+
+function mapBillingModules(billingProvider) {
+  if (billingProvider === "stripe") {
+    return ["billing-stripe"];
+  }
+
+  if (billingProvider === "polar") {
+    return ["billing-polar"];
+  }
+
+  if (billingProvider === "both") {
+    return ["billing-stripe", "billing-polar"];
+  }
+
+  return [];
+}
+
+function mapEmailModules(emailProvider) {
+  if (emailProvider === "resend") {
+    return ["email-resend"];
+  }
+
+  return [];
+}
+
+function mapAuthModules(authMode) {
+  if (authMode === "email-password+github") {
+    return ["auth-github"];
+  }
+
+  if (authMode === "email-password+google") {
+    return ["auth-google"];
+  }
+
+  if (authMode === "email-password+github+google") {
+    return ["auth-github", "auth-google"];
+  }
+
+  return [];
+}
+
+function mapDeployModules(deployTarget) {
+  if (deployTarget === "docker") {
+    return ["deploy-docker"];
+  }
+
+  return [];
+}
+
+function mapAiDxModules(aiTools) {
+  if (!aiTools || aiTools.length === 0) {
+    return [];
+  }
+
+  const modules = ["ai-dx"];
+  const toolToModule = {
+    cursor: "ai-dx-cursor",
+    claude: "ai-dx-claude",
+    gemini: "ai-dx-gemini"
+  };
+
+  for (const tool of aiTools) {
+    if (toolToModule[tool]) {
+      modules.push(toolToModule[tool]);
+    }
+  }
+
+  return modules;
+}
+
+async function collectModuleGraph(repoRoot, initialModuleNames) {
+  const visited = new Set();
+  const modules = new Map();
+
+  async function visit(moduleName) {
+    if (visited.has(moduleName)) {
+      return;
+    }
+
+    visited.add(moduleName);
+    const moduleDefinition = await loadModule(repoRoot, moduleName);
+    modules.set(moduleName, moduleDefinition);
+
+    for (const dependency of moduleDefinition.dependsOn ?? []) {
+      await visit(dependency);
+    }
+  }
+
+  for (const moduleName of initialModuleNames) {
+    await visit(moduleName);
+  }
+
+  return modules;
+}
+
+function validateConflicts(modules) {
+  for (const moduleDefinition of modules.values()) {
+    for (const conflict of moduleDefinition.conflictsWith ?? []) {
+      if (modules.has(conflict)) {
+        throw new Error(
+          `Module conflict: ${moduleDefinition.name} cannot be combined with ${conflict}.`
+        );
+      }
+    }
+  }
+}
+
+function sortModules(modules) {
+  const sorted = [];
+  const visited = new Set();
+
+  function visit(moduleName) {
+    if (visited.has(moduleName)) {
+      return;
+    }
+
+    visited.add(moduleName);
+    const moduleDefinition = modules.get(moduleName);
+
+    for (const dependency of moduleDefinition.dependsOn ?? []) {
+      visit(dependency);
+    }
+
+    sorted.push(moduleName);
+  }
+
+  for (const moduleName of modules.keys()) {
+    visit(moduleName);
+  }
+
+  return sorted;
+}
+
+export async function resolveScaffoldPlan(repoRoot, options) {
+  const preset = await loadPreset(repoRoot, options.template);
+  const initialModuleNames = [
+    ...(preset.modules ?? []),
+    mapDatabaseModule(options.databaseDriver),
+    ...mapAuthModules(options.authMode),
+    ...mapBillingModules(options.billingProvider),
+    ...mapEmailModules(options.emailProvider),
+    ...mapDeployModules(options.deployTarget),
+    ...mapAiDxModules(options.aiTools)
+  ];
+  const uniqueModuleNames = [...new Set(initialModuleNames)];
+  const modules = await collectModuleGraph(repoRoot, uniqueModuleNames);
+
+  validateConflicts(modules);
+
+  return {
+    base: preset.base,
+    preset: preset.name,
+    template: preset.template,
+    overrideFiles: preset.overrideFiles ?? [],
+    tokenReplacements: preset.tokenReplacements ?? {},
+    modules: sortModules(modules)
+  };
+}

package/modules/README.md

@@ -0,0 +1,22 @@
+# Modules
+
+This directory contains the first module registry for Skit.
+
+Current status:
+
+- modules are resolved and written into `skit.json`
+- generation still uses the verified template flow
+- modules can now contribute token replacements, pruning rules, and file overlays
+- `dashboard-shell` is the first module that contributes actual app files, currently `/settings` and its dashboard visual theme layer
+
+The first module slice is intentionally small:
+
+- `quality-baseline`
+- `testing-baseline`
+- `auth-core`
+- `db-pg`
+- `db-postgresjs`
+- `billing-stripe`
+- `billing-polar`
+- `email-resend`
+- `dashboard-shell`

package/modules/ai-dx/files/AGENTS.md

@@ -0,0 +1,116 @@
+# __PROJECT_NAME__
+
+> Generated by Skit. Customize freely — this file is yours.
+
+## Tech Stack
+
+- **Framework**: Next.js 16 (App Router, React 19, server components by default)
+- **Language**: TypeScript 5.9 (strict mode, `noUncheckedIndexedAccess`, `exactOptionalPropertyTypes`)
+- **Database**: Drizzle ORM 0.44 + PostgreSQL via `__DATABASE_DRIVER__`
+- **Auth**: Better Auth 1.3 (email/password, session cookies, edge middleware)
+- **Billing**: provider abstraction (`__BILLING_PROVIDER__`) — see `src/lib/billing/`
+- **Email**: `__EMAIL_PROVIDER__` — see `src/lib/email/`
+- **Testing**: Vitest 3.2 (unit, jsdom) + Playwright 1.55 (e2e)
+- **Linting**: ESLint 9 flat config + Prettier (double quotes, no trailing commas, 88 chars)
+- **CI**: GitHub Actions — lint, typecheck, test, build
+
+## Next.js Docs
+
+Before writing Next.js code, read the bundled docs at `node_modules/next/dist/docs/`. Your training data may be outdated — these docs match the installed version.
+
+## Commands
+
+```bash
+pnpm dev              # start dev server
+pnpm build            # production build
+pnpm lint             # eslint (zero warnings allowed)
+pnpm lint:fix         # eslint --fix
+pnpm typecheck        # tsc --noEmit
+pnpm test             # vitest run
+pnpm test:watch       # vitest watch mode
+pnpm test:e2e         # playwright (starts dev server)
+pnpm format           # prettier --write
+pnpm check            # lint + typecheck + test in sequence
+pnpm db:generate      # drizzle-kit generate migration
+pnpm db:migrate       # drizzle-kit migrate
+pnpm db:push          # drizzle-kit push (skip migrations)
+pnpm db:studio        # drizzle-kit studio (GUI)
+pnpm db:seed          # run seed script
+pnpm auth:generate    # regenerate Better Auth schema
+pnpm auth:secret      # generate a new auth secret
+```
+
+## Verification
+
+Always run after making changes:
+
+```bash
+pnpm typecheck && pnpm lint:fix && pnpm format
+```
+
+## MUST DO
+
+- Use `env` from `@/lib/env` for all environment variables — never `process.env`
+- Use server components by default; add `"use client"` only when hooks or browser APIs are needed
+- Keep route files thin — fetch data in server component, delegate logic to `src/lib/`
+- Use `getSession()` from `@/lib/auth-session` for server-side session access
+- Use `authClient` from `@/lib/auth-client` for client-side auth operations
+- Use `type` imports: `import { type Foo }` (enforced by ESLint)
+- Run `pnpm typecheck` after making changes
+- Add new env vars to three places: Zod schema + parse block in `src/lib/env.ts`, and `.env.example`
+
+## MUST NOT DO
+
+- Never access `process.env` outside `src/lib/env.ts` and `drizzle.config.ts` (ESLint enforces this)
+- Never import from `@/db` or `server-only` modules in client components
+- Never use the `any` type
+- Never commit `.env` files or secrets
+- Never skip the pre-commit hook (`pnpm lint-staged && pnpm typecheck`)
+
+## Where to Find Things
+
+| Area | Location |
+|------|----------|
+| App routes | `src/app/` |
+| Auth config | `src/lib/auth.ts` |
+| Auth client | `src/lib/auth-client.ts` |
+| Session helper | `src/lib/auth-session.ts` |
+| Database connection | `src/db/index.ts` |
+| DB schema | `src/db/schema/` |
+| DB migrations | `src/db/migrations/` |
+| DB seeds | `src/db/seeds/index.ts` |
+| Billing providers | `src/lib/billing/` |
+| Email service | `src/lib/email/` |
+| Email templates | `src/lib/email/templates.ts` |
+| Env validation | `src/lib/env.ts` |
+| Route protection | `proxy.ts` (middleware) |
+| ESLint config | `eslint.config.mjs` |
+| Prettier config | `prettier.config.mjs` |
+| CI workflow | `.github/workflows/ci.yml` |
+| Unit tests | `src/**/*.test.{ts,tsx}` |
+| E2E tests | `tests/e2e/` |
+
+## Code Patterns
+
+### Adding a new page
+
+```
+src/app/my-feature/page.tsx   ← server component, thin
+src/lib/my-feature.ts         ← business logic
+```
+
+### Adding a new DB table
+
+1. Create schema file: `src/db/schema/my-table.ts`
+2. Re-export from `src/db/schema/index.ts`
+3. Run `pnpm db:generate` then `pnpm db:migrate`
+
+### Adding a protected route
+
+Edit `proxy.ts` — add the path to both `__PROTECTED_ROUTE_CONDITION__` and `config.matcher`.
+
+### Adding a new env var
+
+1. Add Zod field in `src/lib/env.ts` schema
+2. Add `process.env.MY_VAR` in `parseEnv()` block
+3. Add default value in `.env.example`

package/modules/ai-dx/files/ARCHITECTURE.md

@@ -0,0 +1,103 @@
+# Architecture
+
+> Generated by Skit. Customize freely.
+
+## Directory Tree
+
+```
+├── proxy.ts                    # Edge middleware — route protection
+├── drizzle.config.ts           # Drizzle Kit config
+├── eslint.config.mjs           # ESLint 9 flat config
+├── prettier.config.mjs         # Prettier config
+├── vitest.config.ts            # Vitest config
+├── playwright.config.ts        # Playwright E2E config
+├── .env.example                # Environment variable template
+├── .github/workflows/ci.yml   # CI pipeline
+│
+├── src/
+│   ├── app/                    # Next.js App Router pages
+│   │   ├── layout.tsx          # Root layout
+│   │   ├── page.tsx            # Landing / home page
+│   │   ├── loading.tsx         # Global loading skeleton
+│   │   ├── error.tsx           # Global error boundary
+│   │   ├── not-found.tsx       # 404 page
+│   │   ├── sign-in/            # Sign-in page
+│   │   ├── sign-up/            # Sign-up page
+│   │   ├── dashboard/          # Dashboard page
+│   │   ├── billing/            # Billing page
+│   │   ├── email/              # Email test page
+│   │   └── api/
+│   │       ├── auth/[...all]/  # Better Auth catch-all handler
+│   │       ├── billing/        # Checkout + portal API routes
+│   │       ├── email/          # Email test route
+│   │       └── webhooks/       # Stripe / Polar webhook handlers
+│   │
+│   ├── components/             # Shared React components
+│   │   └── auth/               # Auth form, sign-out button
+│   │
+│   ├── db/
+│   │   ├── index.ts            # Database connection (Drizzle + driver)
+│   │   ├── schema/             # Drizzle table definitions
+│   │   │   ├── index.ts        # Re-exports all schemas
+│   │   │   ├── auth.ts         # Better Auth tables
+│   │   │   └── projects.ts     # Starter project table
+│   │   ├── migrations/         # Generated SQL migrations
+│   │   └── seeds/              # Seed scripts
+│   │
+│   └── lib/
+│       ├── env.ts              # Zod-validated env (single source of truth)
+│       ├── auth.ts             # Better Auth server config
+│       ├── auth-client.ts      # Client-side auth (useSession, signIn, etc.)
+│       ├── auth-session.ts     # Server-side getSession() helper
+│       ├── billing/
+│       │   ├── index.ts        # Provider factory
+│       │   ├── types.ts        # BillingProvider interface
+│       │   └── providers/      # Stripe, Polar implementations
+│       └── email/
+│           ├── index.ts        # sendEmail function
+│           └── templates.ts    # Email HTML templates
+│
+└── tests/
+    └── e2e/                    # Playwright E2E tests
+```
+
+## Request Flow
+
+```
+Browser
+  │
+  ▼
+proxy.ts (Edge Middleware)
+  │ checks session cookie
+  │ redirects unauthenticated users to /sign-in
+  ▼
+src/app/**/page.tsx (Server Component)
+  │ calls getSession() for auth context
+  │ delegates to src/lib/* for business logic
+  ▼
+src/lib/* (Business Logic)
+  │ uses env from src/lib/env.ts
+  │ uses db from src/db/index.ts
+  ▼
+src/db/ (Drizzle ORM → PostgreSQL)
+```
+
+## Key Boundaries
+
+- **`src/lib/env.ts`** is the only file that may read `process.env`. All other files import `env` from it.
+- **`src/db/`** is server-only. Never import it in client components.
+- **`src/lib/auth.ts`** is server-only. Use `src/lib/auth-client.ts` on the client.
+- **`proxy.ts`** runs at the edge. It checks session cookies — no DB access.
+- **`src/lib/billing/types.ts`** defines the provider interface. Implementations live in `providers/`.
+
+## Extension Points
+
+| Want to... | Do this |
+|------------|---------|
+| Add a page | Create `src/app/my-page/page.tsx` (server component) |
+| Add a DB table | New file in `src/db/schema/`, re-export from `index.ts`, run `pnpm db:generate` |
+| Add an API route | Create `src/app/api/my-route/route.ts` |
+| Add a billing provider | Implement `BillingProvider` in `src/lib/billing/providers/` |
+| Add an email template | Add factory in `src/lib/email/templates.ts` |
+| Protect a route | Update condition + matcher in `proxy.ts` |
+| Add an env var | Schema + parse in `src/lib/env.ts`, default in `.env.example` |