create-claudecraft 1.0.0

package/templates/app/App.tsx

@@ -0,0 +1,21 @@
+import { Routes, Route } from 'react-router-dom'
+import { HomePage } from './pages/HomePage'
+import { NotFoundPage } from './pages/NotFoundPage'
+import { ErrorBoundary } from './components/ErrorBoundary'
+import { SkipLink } from './components/ui/SkipLink'
+
+function App() {
+  return (
+    <ErrorBoundary>
+      <SkipLink />
+      <main id="main-content">
+        <Routes>
+          <Route path="/" element={<HomePage />} />
+          <Route path="*" element={<NotFoundPage />} />
+        </Routes>
+      </main>
+    </ErrorBoundary>
+  )
+}
+
+export default App

package/templates/base/CLAUDE.md

@@ -0,0 +1,332 @@
+# claudecraft
+
+Shipshape from the start. This file provides guidance to Claude Code when working with this project.
+
+## Quick Reference
+
+| Aspect | Value |
+|--------|-------|
+| **Framework** | React 18 + TypeScript |
+| **Styling** | Tailwind CSS + DaisyUI |
+| **Build Tool** | Vite |
+| **Package Manager** | Bun |
+| **Port** | 6969 |
+
+---
+
+## Development Commands
+
+```bash
+bun install          # Install dependencies
+bun dev              # Start dev server (port 6969)
+bun run build        # TypeScript check + Vite build
+bun run lint         # Run ESLint
+bun test             # Run tests
+bun run preview      # Preview production build
+
+# Package management
+bun add <package>    # Add dependency
+bun add -d <package> # Add dev dependency
+```
+
+---
+
+## Project Architecture
+
+<!-- Replace with your project description -->
+Brief description of what this project does and its purpose.
+
+### Directory Structure
+
+```
+src/
+├── components/      # Reusable UI components
+│   └── ui/          # Base UI primitives
+├── context/         # React Context providers
+├── pages/           # Route-level components
+├── lib/             # Utilities and helpers
+├── types/           # TypeScript type definitions
+├── hooks/           # Custom React hooks
+└── data/            # Constants and mock data
+```
+
+### Key Files
+
+- `src/App.tsx` - Main application component with routing
+- `src/main.tsx` - Application entry point with providers
+- `src/context/ThemeContext.tsx` - Theme switching logic
+- `vite.config.ts` - Vite configuration with path aliases
+- `tailwind.config.js` - Tailwind + DaisyUI configuration
+
+---
+
+## Design System
+
+### UI Framework: DaisyUI
+
+This project uses [DaisyUI](https://daisyui.com/) for UI components with 32 pre-installed themes.
+
+### Theme Management
+
+```tsx
+import { useTheme } from '@/context/ThemeContext'
+
+function MyComponent() {
+  const { theme, setTheme, themes } = useTheme()
+  // theme: current theme name
+  // setTheme: function to change theme
+  // themes: array of all available themes
+}
+```
+
+### DaisyUI Component Classes
+
+```tsx
+// Buttons
+<button className="btn btn-primary">Primary</button>
+<button className="btn btn-secondary btn-outline">Outline</button>
+<button className="btn btn-lg">Large</button>
+
+// Cards
+<div className="card bg-base-100 shadow-xl">
+  <div className="card-body">
+    <h2 className="card-title">Title</h2>
+    <p>Content</p>
+  </div>
+</div>
+
+// Form inputs
+<input className="input input-bordered" />
+<select className="select select-bordered" />
+<input type="checkbox" className="checkbox checkbox-primary" />
+<input type="checkbox" className="toggle toggle-primary" />
+
+// Alerts
+<div className="alert alert-info">Info message</div>
+<div className="alert alert-success">Success message</div>
+
+// Badges
+<span className="badge badge-primary">Badge</span>
+
+// Loading
+<span className="loading loading-spinner" />
+```
+
+See [DaisyUI docs](https://daisyui.com/components/) for full component list.
+
+---
+
+## Styling Guidelines - IMPORTANT
+
+### DO ✅
+
+- Use **DaisyUI component classes** first (`btn`, `card`, `input`)
+- Use **DaisyUI semantic colors** (`bg-base-100`, `text-primary`, `bg-neutral`)
+- Use **solid colors with opacity** when needed (`bg-black/50`, `border-primary/30`)
+- Use **clean borders** for separation and visual hierarchy
+- Apply **hover states** with `transition-all`
+- Include **dark mode variants** using DaisyUI themes
+- Keep it **minimal**: lots of whitespace, subtle shadows
+
+### DON'T ❌
+
+- **NO excessive gradients** - Don't overuse `bg-gradient-to-*` for decorative effects
+- **NO fake glows** - Avoid `blur-*`, `shadow-*-glow` for artificial light emission
+- **NO heavy shadows** - Prefer `shadow-sm` or `shadow-md` over `shadow-2xl`
+- **DON'T mix design systems** - Stay consistent with DaisyUI patterns
+- **DON'T forget accessibility** - Always include focus states and ARIA attributes
+
+---
+
+## Component Patterns
+
+### Standard Component Structure
+
+```tsx
+interface Props {
+  title: string
+  variant?: 'primary' | 'secondary'
+  onAction?: () => void
+}
+
+export function ComponentName({ title, variant = 'primary', onAction }: Props) {
+  return (
+    <div className="card bg-base-100 shadow-xl">
+      <div className="card-body">
+        <h2 className="card-title">{title}</h2>
+        <button className={`btn btn-${variant}`} onClick={onAction}>
+          Action
+        </button>
+      </div>
+    </div>
+  )
+}
+```
+
+### Icon Pattern
+
+```tsx
+import { IconName } from 'lucide-react'
+
+// Icons inherit text color
+<IconName className="w-5 h-5 text-base-content" />
+<IconName className="w-6 h-6 text-primary" />
+```
+
+### Form Pattern
+
+```tsx
+<div className="form-control w-full">
+  <label className="label">
+    <span className="label-text">Label</span>
+  </label>
+  <input
+    type="text"
+    placeholder="Placeholder"
+    className="input input-bordered w-full"
+  />
+  <label className="label">
+    <span className="label-text-alt">Helper text</span>
+  </label>
+</div>
+```
+
+---
+
+## Coding Guidelines
+
+### Naming Conventions
+
+| Type | Convention | Example |
+|------|------------|---------|
+| Components | PascalCase | `UserProfile.tsx` |
+| Functions/hooks | camelCase | `useAuth.ts`, `formatDate.ts` |
+| Types/interfaces | PascalCase | `UserData`, `ApiResponse` |
+| Constants | SCREAMING_SNAKE_CASE | `MAX_RETRIES` |
+| Files | Match export name | `UserProfile.tsx` exports `UserProfile` |
+
+### TypeScript Guidelines
+
+- Use TypeScript interfaces in separate `types.ts` files for shared types
+- Prefer `interface` over `type` for object shapes
+- Always type component props
+- Use strict mode (enabled in tsconfig)
+
+### State Management
+
+- Theme state via `ThemeContext`
+- Local state with `useState` for component-specific data
+- Consider Zustand for complex global state
+
+---
+
+## File Organization
+
+### Component Files
+
+```
+src/components/
+├── ui/              # Base primitives (Button, Input, Modal)
+├── layout/          # Layout components (Header, Sidebar, Footer)
+├── features/        # Feature-specific components
+└── shared/          # Shared across features
+```
+
+### Types Files
+
+```
+src/types/
+├── index.ts         # Common types, re-exports
+├── api.ts           # API response types
+└── [feature].ts     # Feature-specific types
+```
+
+---
+
+## Testing
+
+```bash
+bun test               # Run all tests
+bun test --watch       # Watch mode
+bun run test:coverage  # With coverage report
+```
+
+- Tests live next to source files: `Component.tsx` → `Component.test.tsx`
+- Use React Testing Library for component tests
+- Test behavior, not implementation
+
+---
+
+## Environment Variables
+
+Create `.env.local` for local development (never commit):
+
+```env
+VITE_API_URL=http://localhost:3001
+VITE_DEBUG=true
+```
+
+Access in code: `import.meta.env.VITE_API_URL`
+
+---
+
+## Common Tasks
+
+### Adding a New Theme
+
+Edit `tailwind.config.js` and add to the `daisyui.themes` array:
+
+```js
+{
+  mytheme: {
+    "primary": "#6366f1",
+    "secondary": "#f472b6",
+    // ... other colors
+  },
+}
+```
+
+### Adding a New Component
+
+1. Create file in `src/components/ui/`
+2. Use DaisyUI classes for styling
+3. Export from component file
+4. Add types if needed
+
+### Adding a New Page
+
+1. Create component in `src/pages/`
+2. Add route in `src/App.tsx`
+3. Update navigation if needed
+
+---
+
+## Common Mistakes to Avoid
+
+❌ **Don't** use inline styles when Tailwind/DaisyUI classes exist
+✅ **Do** use utility classes: `className="p-4 rounded-lg"`
+
+❌ **Don't** create custom CSS for standard components
+✅ **Do** use DaisyUI: `className="btn btn-primary"`
+
+❌ **Don't** hardcode colors like `text-[#333]`
+✅ **Do** use semantic colors: `text-base-content`
+
+❌ **Don't** forget loading and error states
+✅ **Do** handle all UI states: loading, error, empty, success
+
+❌ **Don't** mix different icon libraries
+✅ **Do** stick to Lucide React for consistency
+
+❌ **Don't** skip TypeScript types
+✅ **Do** type all props and return values
+
+---
+
+## Notes
+
+<!-- Add project-specific notes, gotchas, or important context -->
+- Uses **bun** as package manager (faster than npm/yarn)
+- Theme persists in localStorage
+- Path alias `@/` maps to `src/`
+- All DaisyUI themes are pre-installed

package/templates/base/eslint.config.js

@@ -0,0 +1,28 @@
+import js from '@eslint/js'
+import globals from 'globals'
+import reactHooks from 'eslint-plugin-react-hooks'
+import reactRefresh from 'eslint-plugin-react-refresh'
+import tseslint from 'typescript-eslint'
+
+export default tseslint.config(
+  { ignores: ['dist'] },
+  {
+    extends: [js.configs.recommended, ...tseslint.configs.recommended],
+    files: ['**/*.{ts,tsx}'],
+    languageOptions: {
+      ecmaVersion: 2020,
+      globals: globals.browser,
+    },
+    plugins: {
+      'react-hooks': reactHooks,
+      'react-refresh': reactRefresh,
+    },
+    rules: {
+      ...reactHooks.configs.recommended.rules,
+      'react-refresh/only-export-components': [
+        'warn',
+        { allowConstantExport: true },
+      ],
+    },
+  },
+)

package/templates/base/index.html

@@ -0,0 +1,17 @@
+<!DOCTYPE html>
+<html lang="en" data-theme="halloween">
+  <head>
+    <meta charset="UTF-8" />
+    <link rel="icon" type="image/svg+xml" href="/vite.svg" />
+    <meta name="viewport" content="width=device-width, initial-scale=1.0" />
+    <link rel="preconnect" href="https://fonts.googleapis.com" />
+    <link rel="preconnect" href="https://fonts.gstatic.com" crossorigin />
+    <link href="https://fonts.googleapis.com/css2?family=Caveat:wght@500;600&display=swap" rel="stylesheet" />
+    <meta name="description" content="Shipshape from the start. A designer-first boilerplate for building non-slop with Claude Code." />
+    <title>claudecraft — Shipshape from the start</title>
+  </head>
+  <body>
+    <div id="root"></div>
+    <script type="module" src="/src/main.tsx"></script>
+  </body>
+</html>

package/templates/base/package.json

@@ -0,0 +1,43 @@
+{
+  "name": "claudecraft",
+  "private": true,
+  "version": "0.0.1",
+  "type": "module",
+  "scripts": {
+    "dev": "vite",
+    "build": "tsc -b && vite build",
+    "lint": "eslint .",
+    "preview": "vite preview",
+    "test": "vitest",
+    "test:coverage": "vitest run --coverage"
+  },
+  "dependencies": {
+    "react": "^18.3.1",
+    "react-dom": "^18.3.1",
+    "react-router-dom": "^7.12.0",
+    "lucide-react": "^0.460.0",
+    "clsx": "^2.1.1",
+    "tailwind-merge": "^2.5.4"
+  },
+  "devDependencies": {
+    "@eslint/js": "^9.13.0",
+    "@tailwindcss/typography": "^0.5.19",
+    "@testing-library/jest-dom": "^6.6.2",
+    "@testing-library/react": "^16.0.1",
+    "@types/react": "^18.3.12",
+    "@types/react-dom": "^18.3.1",
+    "@vitejs/plugin-react": "^4.3.3",
+    "autoprefixer": "^10.4.20",
+    "daisyui": "^4.12.14",
+    "eslint": "^9.13.0",
+    "eslint-plugin-react-hooks": "^5.0.0",
+    "eslint-plugin-react-refresh": "^0.4.13",
+    "globals": "^15.11.0",
+    "postcss": "^8.4.47",
+    "tailwindcss": "^3.4.14",
+    "typescript": "~5.6.2",
+    "typescript-eslint": "^8.10.0",
+    "vite": "^5.4.10",
+    "vitest": "^2.1.4"
+  }
+}

package/templates/base/postcss.config.js

@@ -0,0 +1,6 @@
+export default {
+  plugins: {
+    tailwindcss: {},
+    autoprefixer: {},
+  },
+}

package/templates/base/tailwind.config.js

@@ -0,0 +1,81 @@
+/** @type {import('tailwindcss').Config} */
+export default {
+  content: [
+    "./index.html",
+    "./src/**/*.{js,ts,jsx,tsx}",
+  ],
+  theme: {
+    extend: {},
+  },
+  plugins: [require("@tailwindcss/typography"), require("daisyui")],
+  daisyui: {
+    themes: [
+      // Light themes
+      "light",
+      "cupcake",
+      "bumblebee",
+      "emerald",
+      "corporate",
+      "garden",
+      "lofi",
+      "pastel",
+      "fantasy",
+      "wireframe",
+      "cmyk",
+      "autumn",
+      "acid",
+      "lemonade",
+      "winter",
+      "nord",
+
+      // Dark themes
+      "dark",
+      "synthwave",
+      "retro",
+      "cyberpunk",
+      "valentine",
+      "halloween",
+      "aqua",
+      "forest",
+      "black",
+      "luxury",
+      "dracula",
+      "business",
+      "night",
+      "coffee",
+      "dim",
+      "sunset",
+
+      // Custom theme from theme generator
+      {
+        custom: {
+          "primary": "#6366f1",
+          "primary-content": "#ffffff",
+          "secondary": "#f472b6",
+          "secondary-content": "#ffffff",
+          "accent": "#22d3ee",
+          "accent-content": "#000000",
+          "neutral": "#1f2937",
+          "neutral-content": "#d1d5db",
+          "base-100": "#ffffff",
+          "base-200": "#f3f4f6",
+          "base-300": "#e5e7eb",
+          "base-content": "#1f2937",
+          "info": "#3b82f6",
+          "info-content": "#ffffff",
+          "success": "#22c55e",
+          "success-content": "#ffffff",
+          "warning": "#f59e0b",
+          "warning-content": "#000000",
+          "error": "#ef4444",
+          "error-content": "#ffffff",
+        },
+      },
+    ],
+    darkTheme: "dark",
+    base: true,
+    styled: true,
+    utils: true,
+    logs: false,
+  },
+}

package/templates/base/tsconfig.json

@@ -0,0 +1,25 @@
+{
+  "compilerOptions": {
+    "target": "ES2022",
+    "useDefineForClassFields": true,
+    "lib": ["ES2022", "DOM", "DOM.Iterable"],
+    "module": "ESNext",
+    "skipLibCheck": true,
+    "moduleResolution": "bundler",
+    "allowImportingTsExtensions": true,
+    "isolatedModules": true,
+    "moduleDetection": "force",
+    "noEmit": true,
+    "jsx": "react-jsx",
+    "strict": true,
+    "noUnusedLocals": true,
+    "noUnusedParameters": true,
+    "noFallthroughCasesInSwitch": true,
+    "noUncheckedSideEffectImports": true,
+    "baseUrl": ".",
+    "paths": {
+      "@/*": ["./src/*"]
+    }
+  },
+  "include": ["src"]
+}

package/templates/base/vite.config.ts

@@ -0,0 +1,16 @@
+import { defineConfig } from 'vite'
+import react from '@vitejs/plugin-react'
+import path from 'path'
+
+export default defineConfig({
+  plugins: [react()],
+  resolve: {
+    alias: {
+      '@': path.resolve(__dirname, './src'),
+    },
+  },
+  server: {
+    port: 6969,
+    host: true,
+  },
+})

package/templates/commands/brainstorm.md

@@ -0,0 +1,6 @@
+---
+description: "You MUST use this before any creative work - creating features, building components, adding functionality, or modifying behavior. Explores requirements and design before implementation."
+disable-model-invocation: true
+---
+
+Invoke the superpowers:brainstorming skill and follow it exactly as presented to you

package/templates/commands/build.md

@@ -0,0 +1,41 @@
+# /build Command
+
+Run the project build and provide a structured summary of results.
+
+## Steps
+
+1. Run `bun run build` to execute TypeScript compilation and Vite build
+
+2. Parse the output for:
+   - TypeScript errors (with file locations)
+   - Build warnings
+   - Bundle size information
+   - Build success/failure status
+
+3. Format results as:
+
+```markdown
+## Build Results
+
+**Status:** ✅ Success | ❌ Failed
+
+### TypeScript Errors (if any)
+| File | Line | Error |
+|------|------|-------|
+| ... | ... | ... |
+
+### Warnings (if any)
+- ...
+
+### Bundle Info
+- Output directory: dist/
+- Total size: X KB
+```
+
+4. If errors found:
+   - Suggest fixes for common issues
+   - Offer to fix automatically if straightforward
+
+5. If successful:
+   - Report build time
+   - Note any optimization opportunities

package/templates/commands/execute-plan.md

@@ -0,0 +1,6 @@
+---
+description: Execute plan in batches with review checkpoints
+disable-model-invocation: true
+---
+
+Invoke the superpowers:executing-plans skill and follow it exactly as presented to you

package/templates/commands/lint.md

@@ -0,0 +1,41 @@
+# /lint Command
+
+Run ESLint and provide a structured summary of linting issues.
+
+## Steps
+
+1. Run `bun run lint` to execute ESLint
+
+2. Parse the output for:
+   - Errors (blocking issues)
+   - Warnings (suggestions)
+   - File locations and line numbers
+
+3. Format results as:
+
+```markdown
+## Lint Results
+
+**Status:** ✅ No issues | ⚠️ X warnings | ❌ Y errors
+
+### Errors
+| File | Line | Rule | Message |
+|------|------|------|---------|
+| ... | ... | ... | ... |
+
+### Warnings
+| File | Line | Rule | Message |
+|------|------|------|---------|
+| ... | ... | ... | ... |
+
+### Summary
+- Files checked: X
+- Errors: Y
+- Warnings: Z
+```
+
+4. For fixable issues:
+   - Offer to run `bun run lint --fix`
+
+5. For manual fixes:
+   - Suggest specific code changes