@samahlstrom/forge-cli 0.1.0

package/templates/presets/react-next-ts/stack.md.hbs

@@ -0,0 +1,77 @@
+# Stack Context: Next.js + React + TypeScript
+
+## Tech Stack
+
+- **Framework**: Next.js 14+ (App Router)
+- **Language**: TypeScript (strict mode)
+- **UI**: React 19
+- **Styling**: Tailwind CSS
+- **Testing**: Vitest or Jest
+- **Linting**: ESLint (next/core-web-vitals)
+
+## Project Structure
+
+```
+app/
+  layout.tsx              # Root layout
+  page.tsx                # Home page
+  (routes)/               # Route groups
+    dashboard/
+      page.tsx            # Dashboard page
+      loading.tsx         # Loading UI
+      error.tsx           # Error boundary
+  api/                    # API routes (Route Handlers)
+    endpoint/
+      route.ts
+src/
+  components/             # Reusable UI components
+  lib/                    # Utilities and shared code
+  hooks/                  # Custom React hooks
+  types/                  # TypeScript types
+  services/               # Business logic / data access
+```
+
+## Key Patterns
+
+### Server vs Client Components
+- **Default is Server Component** — no "use client" directive
+- Add `"use client"` only when you need: useState, useEffect, event handlers, browser APIs
+- Keep client components as small as possible — push state to leaves
+- Never pass functions as props from server to client components
+
+### Data Fetching
+- Fetch data in Server Components using `async/await`
+- Use `fetch()` with Next.js caching: `fetch(url, { next: { revalidate: 60 } })`
+- For mutations, use Server Actions (`"use server"`)
+- Never fetch in client components if a Server Component can do it
+
+### API Routes (Route Handlers)
+- File: `app/api/<path>/route.ts`
+- Export named functions: `GET`, `POST`, `PUT`, `DELETE`
+- Always validate input with Zod or similar
+- Return `NextResponse.json()` with proper status codes
+
+### Server Actions
+- Define with `"use server"` directive
+- Use for form submissions and mutations
+- Always validate input — they're public endpoints
+- Return typed results, not just void
+
+### Metadata
+- Export `metadata` object or `generateMetadata` function
+- Include title, description, OpenGraph for all pages
+
+## Anti-Patterns
+
+- Never use `any` type
+- Never use `getServerSideProps` / `getStaticProps` (Pages Router patterns)
+- Never mutate state directly — use `setState` or Server Actions
+- Never use `dangerouslySetInnerHTML` without sanitization
+- Never hardcode secrets — use `process.env`
+- Never import server-only code in client components
+
+## Quality Gates
+
+- `npx tsc --noEmit` — TypeScript checking
+- `npx next lint` — Next.js ESLint rules
+- `npx vitest run` — Unit tests

package/templates/presets/sveltekit-ts/stack.md.hbs

@@ -0,0 +1,116 @@
+# Stack Context: SvelteKit + TypeScript
+
+## Tech Stack
+
+- **Framework**: SvelteKit 2 with Svelte 5
+- **Language**: TypeScript (strict mode)
+- **Styling**: Tailwind CSS 4
+- **Testing**: Vitest (unit) + Playwright (e2e)
+- **Linting**: ESLint + Prettier
+
+## Code Style
+
+- Tabs for indentation
+- Single quotes
+- 100 character line width
+- No semicolons (Prettier default)
+
+## Svelte 5 Rules (CRITICAL)
+
+Use Svelte 5 runes exclusively. Never use Svelte 4 reactive syntax.
+
+```svelte
+<!-- CORRECT: Svelte 5 runes -->
+<script lang="ts">
+  let count = $state(0);
+  let doubled = $derived(count * 2);
+  let { data, onSubmit }: Props = $props();
+
+  $effect(() => {
+    console.log('count changed:', count);
+  });
+</script>
+```
+
+**Never use**: `export let`, `$:`, `$$props`, `$$restProps`, `createEventDispatcher`
+
+## Project Structure
+
+```
+src/
+  routes/          # SvelteKit routes (pages + API)
+    +page.svelte         # Page component
+    +page.server.ts      # Server load function
+    +page.ts             # Universal load function
+    +server.ts           # API endpoint
+    +layout.svelte       # Layout component
+  lib/
+    components/          # Reusable UI components
+    server/              # Server-only code (NEVER import on client)
+    services/            # Business logic
+    state/               # State management (*.svelte.ts files with runes)
+    types/               # TypeScript type definitions
+  hooks.server.ts        # Server hooks (auth, middleware)
+  app.css                # Global styles
+```
+
+## Key Patterns
+
+### Server-Only Code
+- All server-only code lives in `src/lib/server/`
+- NEVER import from `$lib/server/` in client components
+- Use `+page.server.ts` for data that requires server access
+
+### Load Functions
+- `+page.server.ts` — server-side only, has access to secrets and DB
+- `+page.ts` — universal, runs on both server and client
+- Return only serializable data from load functions
+
+### API Routes
+- File: `+server.ts` with `RequestHandler` typing
+- Always validate input
+- Always check authentication via `event.locals`
+- Return proper HTTP status codes
+
+### State Management
+- Use `*.svelte.ts` files with `$state()` runes
+- Store files in `src/lib/state/`
+- No global mutable stores — prefer passing state via props
+
+### Component Patterns
+
+**Atomic Design Hierarchy:**
+- Atoms → Molecules → Organisms → Templates → Pages
+- Lower levels NEVER fetch data
+- Lower levels NEVER import from higher levels
+
+**Required on interactive elements:**
+- `data-testid` attribute for testing
+- Proper semantic HTML (`<button>`, not `<div onclick>`)
+- Accessibility: `aria-label`, keyboard support
+
+### Styling
+- Tailwind CSS 4 classes only — no inline styles, no CSS modules
+- Design tokens: define in `app.css`, use as Tailwind classes
+
+### Z-Index Hierarchy
+- Drawer: z-60
+- Modal: z-52
+- Modal header: z-40
+- Dropdown: z-20
+
+## Anti-Patterns
+
+- Never use Svelte 4 reactive syntax (`$:`, `export let`)
+- Never use `<div>` or `<span>` as clickable elements — use `<button>` or `<a>`
+- Never use `any` type
+- Never use `node` type for scripts
+- Never fetch data in atoms, molecules, or organisms
+- Never import higher-level components (organism importing a template)
+- Never import `$lib/server/` code in client files
+
+## Quality Gates
+
+- `npm run check` — TypeScript + Svelte type checking
+- `npx vitest run` — Unit tests
+- `npm run lint` — ESLint + Prettier