create-edhor-stack 0.1.0

package/templates/base/CLAUDE.md.hbs

@@ -0,0 +1,139 @@
+# CLAUDE.md
+
+This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.
+
+## Project Overview
+
+{{name}} is a Bun + Turborepo monorepo scaffolded with [create-edhor-stack](https://github.com/your-username/create-edhor-stack).
+
+## Commands
+
+```bash
+# Root (monorepo)
+bun dev              # Start all apps in development
+bun build            # Build all apps and packages
+bun lint             # Lint with Biome
+bun check            # Lint + format with auto-fix
+bun clean            # Clean all build artifacts
+
+# Filter to specific app
+bun dev --filter=web     # Start web app only
+bun dev --filter=mobile  # Start mobile app only
+```
+
+## Architecture
+
+### Monorepo Structure
+
+```
+{{name}}/
+├── apps/
+│   ├── web/              # TanStack Start web application
+│   │   ├── src/
+│   │   │   ├── routes/   # File-based routing
+│   │   │   └── lib/      # Utilities, query client
+│   │   └── package.json
+│   └── mobile/           # Expo React Native application
+│       ├── app/          # Expo Router screens
+│       ├── src/
+│       │   ├── api/      # API client, schemas, queries
+│       │   ├── lib/      # Store, utils, query client
+│       │   └── hooks/    # Custom React hooks
+│       └── package.json
+├── packages/
+│   └── ui/               # Shared UI components (shadcn/ui)
+├── turbo.json            # Turborepo configuration
+├── biome.json            # Linting & formatting rules
+└── package.json          # Root workspace configuration
+```
+
+### Tech Stack
+
+| Layer | Technology |
+|-------|------------|
+| Package Manager | Bun |
+| Monorepo | Turborepo |
+| Web Framework | TanStack Start |
+| Mobile Framework | Expo SDK 54 + Expo Router |
+| State (Server) | TanStack Query |
+| State (Client) | Zustand (mobile) |
+| Validation | Zod |
+| Styling | Tailwind CSS v4, shadcn/ui |
+| Icons | Lucide |
+| Linting | Biome |
+
+### Key Patterns
+
+**State Management (Mobile)**:
+- Multiple specialized Zustand stores with `persist()` middleware
+- Use selectors to prevent re-renders: `useAppStore(state => state.theme)`
+- Never destructure the whole store
+
+**API Layer**:
+- `fetchValidated()` wraps fetch with Zod schema validation
+- Query options factories for React Query consistency
+- Offline-first configuration with 7-day cache
+
+**Routing**:
+- Web: TanStack Router file-based routing in `src/routes/`
+- Mobile: Expo Router file-based routing in `app/`
+
+### Import Alias
+
+All imports use `@/` prefix mapping to `src/`:
+
+```typescript
+import { useAppStore } from '@/lib/store';
+import { fetchValidated } from '@/api/client';
+```
+
+## Code Style
+
+Enforced by Biome (`biome.json`):
+- 2-space indentation, 100-char line width
+- Single quotes, ES5 trailing commas, semicolons
+- `useImportType` for type-only imports
+- No unused imports (error), no unused variables (warn)
+
+Section comments format:
+```typescript
+// ============================================================================
+// SECTION NAME
+// ============================================================================
+```
+
+## Development Guidelines
+
+### Adding a New Route (Web)
+
+1. Create file in `apps/web/src/routes/` (e.g., `dashboard.tsx`)
+2. Export Route with `createFileRoute`
+3. Use route loaders for data fetching
+
+### Adding a New Screen (Mobile)
+
+1. Create file in `apps/mobile/app/` (e.g., `settings.tsx`)
+2. Use `useLocalSearchParams` for dynamic routes
+3. Connect to Zustand stores via selectors
+
+### Adding API Endpoints
+
+1. Define Zod schema in `src/api/schemas.ts`
+2. Create query options in `src/api/queries.ts`
+3. Use `fetchValidated()` for type-safe fetching
+
+## AI Agent Instructions
+
+See [AGENTS.md](./AGENTS.md) for multi-agent workflow documentation.
+
+### Preferred Approaches
+
+- **TDD**: Write failing tests first, then implement
+- **Small commits**: Commit after each logical change
+- **DRY/YAGNI**: Don't over-engineer, build what's needed
+
+### Before Making Changes
+
+1. Read relevant files to understand context
+2. Check existing patterns in similar files
+3. Run `bun check` before committing

package/templates/base/Dockerfile

@@ -0,0 +1,32 @@
+# syntax=docker/dockerfile:1
+
+# Build stage
+FROM oven/bun:1 AS builder
+WORKDIR /app
+
+# Copy package files
+COPY package.json bun.lock* ./
+COPY apps/web/package.json ./apps/web/
+COPY packages/*/package.json ./packages/
+
+# Install dependencies
+RUN bun install --frozen-lockfile
+
+# Copy source
+COPY . .
+
+# Build the web app
+RUN bun run build --filter=web
+
+# Production stage
+FROM oven/bun:1-slim AS runner
+WORKDIR /app
+
+ENV NODE_ENV=production
+
+# Copy built application
+COPY --from=builder /app/apps/web/.output ./.output
+
+# Run the server
+EXPOSE 3000
+CMD ["bun", "run", ".output/server/index.mjs"]

package/templates/base/biome.json

@@ -0,0 +1,52 @@
+{
+  "$schema": "https://biomejs.dev/schemas/2.3.11/schema.json",
+  "vcs": {
+    "enabled": true,
+    "clientKind": "git",
+    "useIgnoreFile": true
+  },
+  "files": {
+    "ignoreUnknown": true,
+    "includes": ["apps/**/*.ts", "apps/**/*.tsx", "packages/**/*.ts", "packages/**/*.tsx"]
+  },
+  "formatter": {
+    "enabled": true,
+    "indentStyle": "space",
+    "indentWidth": 2,
+    "lineWidth": 100
+  },
+  "assist": {
+    "actions": {
+      "source": {
+        "organizeImports": "on"
+      }
+    }
+  },
+  "linter": {
+    "enabled": true,
+    "rules": {
+      "recommended": true,
+      "correctness": {
+        "useExhaustiveDependencies": "warn",
+        "noUnusedImports": "error",
+        "noUnusedVariables": "warn"
+      },
+      "style": {
+        "noNonNullAssertion": "off",
+        "useConst": "error",
+        "useImportType": "error"
+      },
+      "suspicious": {
+        "noExplicitAny": "warn",
+        "noConsole": "off"
+      }
+    }
+  },
+  "javascript": {
+    "formatter": {
+      "quoteStyle": "double",
+      "trailingCommas": "es5",
+      "semicolons": "always"
+    }
+  }
+}

package/templates/base/fly.toml.hbs

@@ -0,0 +1,20 @@
+app = "{{name}}"
+primary_region = "iad"
+
+[build]
+
+[http_service]
+  internal_port = 3000
+  force_https = true
+  auto_stop_machines = "stop"
+  auto_start_machines = true
+  min_machines_running = 0
+  processes = ["app"]
+
+[env]
+  NODE_ENV = "production"
+
+[[vm]]
+  memory = "512mb"
+  cpu_kind = "shared"
+  cpus = 1

package/templates/base/gitignore

@@ -0,0 +1,36 @@
+# Dependencies
+node_modules/
+
+# Build outputs
+dist/
+.output/
+.vinxi/
+.expo/
+build/
+
+# Turbo
+.turbo/
+
+# Environment
+.env
+.env.local
+.env.*.local
+
+# IDE
+.idea/
+.vscode/
+*.swp
+*.swo
+
+# OS
+.DS_Store
+Thumbs.db
+
+# Logs
+*.log
+npm-debug.log*
+
+# Testing
+coverage/
+playwright-report/
+test-results/

package/templates/base/package.json.hbs

@@ -0,0 +1,22 @@
+{
+  "name": "{{name}}",
+  "private": true,
+  "workspaces": ["apps/*", "packages/*"],
+  "scripts": {
+    "dev": "turbo dev",
+    "build": "turbo build",
+    "lint": "biome lint .",
+    "format": "biome format --write .",
+    "check": "biome check --write .",
+    "clean": "turbo clean && rm -rf node_modules",
+    "prepare": "husky"
+  },
+  "devDependencies": {
+    "@biomejs/biome": "2.3.11",
+    "husky": "^9.1.7",
+    "lint-staged": "^16.1.0",
+    "turbo": "^2.5.4",
+    "typescript": "^5.8.3"
+  },
+  "packageManager": "bun@1.3.5"
+}

package/templates/base/tsconfig.json

@@ -0,0 +1,14 @@
+{
+  "compilerOptions": {
+    "target": "ES2022",
+    "lib": ["ES2022", "DOM", "DOM.Iterable"],
+    "module": "ESNext",
+    "moduleResolution": "bundler",
+    "strict": true,
+    "esModuleInterop": true,
+    "skipLibCheck": true,
+    "resolveJsonModule": true,
+    "isolatedModules": true,
+    "noEmit": true
+  }
+}

package/templates/base/turbo.json

@@ -0,0 +1,22 @@
+{
+  "$schema": "https://turbo.build/schema.json",
+  "tasks": {
+    "build": {
+      "dependsOn": ["^build"],
+      "outputs": ["dist/**", ".output/**", ".vinxi/**"]
+    },
+    "dev": {
+      "cache": false,
+      "persistent": true
+    },
+    "lint": {
+      "dependsOn": ["^lint"]
+    },
+    "typecheck": {
+      "dependsOn": ["^build"]
+    },
+    "clean": {
+      "cache": false
+    }
+  }
+}

package/templates/packages/shared/package.json

@@ -0,0 +1,17 @@
+{
+  "name": "@{{name}}/shared",
+  "private": true,
+  "type": "module",
+  "exports": {
+    ".": "./src/index.ts",
+    "./schemas": "./src/schemas.ts",
+    "./types": "./src/types.ts",
+    "./utils": "./src/utils.ts"
+  },
+  "dependencies": {
+    "zod": "^3.24.0"
+  },
+  "devDependencies": {
+    "typescript": "^5.8.0"
+  }
+}

package/templates/packages/shared/src/index.ts

@@ -0,0 +1,4 @@
+// Re-export everything from submodules
+export * from './schemas';
+export * from './types';
+export * from './utils';

package/templates/packages/shared/src/schemas.ts

@@ -0,0 +1,50 @@
+import { z } from 'zod';
+
+// ============================================================================
+// COMMON SCHEMAS
+// ============================================================================
+
+export const IdSchema = z.string().uuid();
+
+export const PaginationSchema = z.object({
+  page: z.number().int().positive().default(1),
+  limit: z.number().int().positive().max(100).default(20),
+});
+
+export const TimestampsSchema = z.object({
+  createdAt: z.string().datetime(),
+  updatedAt: z.string().datetime(),
+});
+
+// ============================================================================
+// USER SCHEMAS
+// ============================================================================
+
+export const UserSchema = z.object({
+  id: IdSchema,
+  email: z.string().email(),
+  name: z.string().min(1),
+  image: z.string().url().optional(),
+});
+
+export const CreateUserSchema = UserSchema.omit({ id: true });
+export const UpdateUserSchema = UserSchema.partial().omit({ id: true });
+
+// ============================================================================
+// API RESPONSE SCHEMAS
+// ============================================================================
+
+export const ApiErrorSchema = z.object({
+  code: z.string(),
+  message: z.string(),
+  details: z.record(z.unknown()).optional(),
+});
+
+export const PaginatedResponseSchema = <T extends z.ZodTypeAny>(itemSchema: T) =>
+  z.object({
+    items: z.array(itemSchema),
+    total: z.number().int().nonnegative(),
+    page: z.number().int().positive(),
+    limit: z.number().int().positive(),
+    hasMore: z.boolean(),
+  });

package/templates/packages/shared/src/types.ts

@@ -0,0 +1,47 @@
+import type { z } from 'zod';
+import type {
+  UserSchema,
+  CreateUserSchema,
+  UpdateUserSchema,
+  PaginationSchema,
+  ApiErrorSchema,
+} from './schemas';
+
+// ============================================================================
+// INFERRED TYPES FROM SCHEMAS
+// ============================================================================
+
+export type User = z.infer<typeof UserSchema>;
+export type CreateUser = z.infer<typeof CreateUserSchema>;
+export type UpdateUser = z.infer<typeof UpdateUserSchema>;
+export type Pagination = z.infer<typeof PaginationSchema>;
+export type ApiError = z.infer<typeof ApiErrorSchema>;
+
+// ============================================================================
+// UTILITY TYPES
+// ============================================================================
+
+export type PaginatedResponse<T> = {
+  items: T[];
+  total: number;
+  page: number;
+  limit: number;
+  hasMore: boolean;
+};
+
+export type Result<T, E = ApiError> =
+  | { ok: true; data: T }
+  | { ok: false; error: E };
+
+// ============================================================================
+// API TYPES
+// ============================================================================
+
+export type HttpMethod = 'GET' | 'POST' | 'PUT' | 'PATCH' | 'DELETE';
+
+export type ApiEndpoint<TInput, TOutput> = {
+  method: HttpMethod;
+  path: string;
+  input: TInput;
+  output: TOutput;
+};

package/templates/packages/shared/src/utils.ts

@@ -0,0 +1,87 @@
+import type { Result, ApiError } from './types';
+
+// ============================================================================
+// RESULT HELPERS
+// ============================================================================
+
+export const ok = <T>(data: T): Result<T, never> => ({ ok: true, data });
+export const err = <E = ApiError>(error: E): Result<never, E> => ({ ok: false, error });
+
+// ============================================================================
+// STRING UTILS
+// ============================================================================
+
+export function slugify(text: string): string {
+  return text
+    .toLowerCase()
+    .trim()
+    .replace(/[^\w\s-]/g, '')
+    .replace(/[\s_-]+/g, '-')
+    .replace(/^-+|-+$/g, '');
+}
+
+export function truncate(text: string, maxLength: number, suffix = '...'): string {
+  if (text.length <= maxLength) return text;
+  return text.slice(0, maxLength - suffix.length) + suffix;
+}
+
+export function capitalize(text: string): string {
+  return text.charAt(0).toUpperCase() + text.slice(1);
+}
+
+// ============================================================================
+// DATE UTILS
+// ============================================================================
+
+export function formatDate(date: Date | string, locale = 'en-US'): string {
+  const d = typeof date === 'string' ? new Date(date) : date;
+  return d.toLocaleDateString(locale, {
+    year: 'numeric',
+    month: 'long',
+    day: 'numeric',
+  });
+}
+
+export function formatRelativeTime(date: Date | string): string {
+  const d = typeof date === 'string' ? new Date(date) : date;
+  const now = new Date();
+  const diffMs = now.getTime() - d.getTime();
+  const diffSecs = Math.floor(diffMs / 1000);
+  const diffMins = Math.floor(diffSecs / 60);
+  const diffHours = Math.floor(diffMins / 60);
+  const diffDays = Math.floor(diffHours / 24);
+
+  if (diffSecs < 60) return 'just now';
+  if (diffMins < 60) return `${diffMins}m ago`;
+  if (diffHours < 24) return `${diffHours}h ago`;
+  if (diffDays < 7) return `${diffDays}d ago`;
+  return formatDate(d);
+}
+
+// ============================================================================
+// OBJECT UTILS
+// ============================================================================
+
+export function omit<T extends object, K extends keyof T>(
+  obj: T,
+  keys: K[]
+): Omit<T, K> {
+  const result = { ...obj };
+  for (const key of keys) {
+    delete result[key];
+  }
+  return result;
+}
+
+export function pick<T extends object, K extends keyof T>(
+  obj: T,
+  keys: K[]
+): Pick<T, K> {
+  const result = {} as Pick<T, K>;
+  for (const key of keys) {
+    if (key in obj) {
+      result[key] = obj[key];
+    }
+  }
+  return result;
+}

package/templates/packages/shared/tsconfig.json

@@ -0,0 +1,14 @@
+{
+  "compilerOptions": {
+    "target": "ES2022",
+    "module": "ESNext",
+    "moduleResolution": "bundler",
+    "strict": true,
+    "esModuleInterop": true,
+    "skipLibCheck": true,
+    "declaration": true,
+    "declarationMap": true,
+    "composite": true
+  },
+  "include": ["src/**/*"]
+}

package/templates/packages/stripe/package.json

@@ -0,0 +1,18 @@
+{
+  "name": "@{{name}}/stripe",
+  "private": true,
+  "type": "module",
+  "exports": {
+    ".": "./src/index.ts",
+    "./client": "./src/client.ts",
+    "./webhooks": "./src/webhooks.ts",
+    "./schemas": "./src/schemas.ts"
+  },
+  "dependencies": {
+    "stripe": "^17.0.0",
+    "zod": "^3.24.0"
+  },
+  "devDependencies": {
+    "typescript": "^5.8.0"
+  }
+}