Claudify

A pre-configured starter repo for building applications with Claude Code, Bun, and Railway / GCP Cloud Run.

Clone it, customize it, start building.

What's Included

Claude Code Configuration

• CLAUDE.md — Lean project context with @import references to modular rules
• .claude/rules/ — Auto-loaded context rules (Bun conventions, testing, deployment, security)
• .claude/settings.json — 7 plugins, permissions, 3 hooks (pre-commit QA, bash safety, auto-format)
• .mcp.json — context7 (live docs) + sequential-thinking (complex reasoning)
• agents.md — Agent usage guide (imported via @agents.md in CLAUDE.md)
• 10 slash commands for dev, test, QA, review, deploy, migrate, scaffold

Opinionated Stack

• Bun runtime (not Node)
• Bun.serve() with HTML imports (not Express, not Vite)
• React 19
• Biome linting (not ESLint)
• Railway + GCP Cloud Run deployment
• bun:test

Quick Start

# 1. Clone
git clone <your-repo-url> my-project
cd my-project

# 2. Environment
cp .env.example .env

# 3. Claude Code local settings
cp .claude/settings.local.json.example .claude/settings.local.json

# 4. Install
bun install

# 5. Run
bun run dev

Then open Claude Code and try /dev, /test, or /qa.

Customization

After cloning, update these files for your project:

1. CLAUDE.md — Replace [Project Name] and [One-line description] at the top
2. package.json — Change name, version, description
3. .env — Set your environment variables
4. .claude/settings.json — Adjust permissions for your team's needs
5. .claude/rules/deployment.md — Update with your Railway/GCP project details

Slash Commands

Command	What it does
/dev	Start dev server with HMR, check port conflicts
/test [filter]	Run tests — supports path, grep, watch, coverage
/qa	Full pipeline: lint + typecheck + test
/review [file|branch]	Code review with Critical/Important/Suggestions
/deploy-dev	QA check + deploy to Railway staging
/deploy-prod	Strict safety checks + deploy to Railway production
/deploy-gcp	QA check + deploy to GCP Cloud Run staging
/deploy-gcp-prod	Strict safety checks + deploy to GCP Cloud Run production
/db-migrate [cmd]	Generate, run, rollback, or check migration status
/new-feature [desc]	Scaffold routes, tests, types for a new feature

Plugins

Plugin	Purpose
frontend-design	Polished, distinctive UI generation
context7	Live library documentation in prompts
superpowers	Structured workflows (brainstorm, plan, execute)
claude-md-management	Keeps CLAUDE.md updated
code-review	Automated code review
security-guidance	Security issue detection
commit-commands	Conventional commit helpers

Safety Features

• Pre-commit hook — Runs lint + typecheck + test before every commit
• Bash safety guard — Blocks rm -rf /, sudo, pipe-to-sh patterns
• Post-write auto-format — Biome formats every file after Write/Edit
• Production deploy protection — /deploy-prod and /deploy-gcp-prod require main branch, clean state, and explicit confirmation
• Permission deny list — Dangerous commands are blocked by default

Architecture

How Claude Code Reads This Repo

CLAUDE.md (auto-loaded at start of every conversation)
  ├── @agents.md (imported — prompting patterns, slash commands, plugins)
  └── @.claude/rules/bun-conventions.md (referenced — Bun API table, frontend patterns)

.claude/rules/ (ALL auto-loaded by Claude Code)
  ├── bun-conventions.md — Bun native APIs, HTML imports pattern
  ├── testing.md — bun:test conventions (scoped to *.test.ts files)
  ├── deployment.md — Railway + GCP Cloud Run
  └── security.md — Secrets, permissions, hooks

.claude/settings.json (auto-loaded)
  ├── enabledPlugins — 7 plugins
  ├── permissions — allow/deny lists
  └── hooks — PreToolUse, PostToolUse, PreCommit

.mcp.json (auto-discovered)
  ├── context7 — Live library documentation
  └── sequential-thinking — Structured reasoning

Project Structure

Claudify/
├── .claude/
│   ├── commands/          # 10 slash commands
│   │   ├── dev.md
│   │   ├── test.md
│   │   ├── qa.md
│   │   ├── review.md
│   │   ├── deploy-dev.md
│   │   ├── deploy-prod.md
│   │   ├── deploy-gcp.md
│   │   ├── deploy-gcp-prod.md
│   │   ├── db-migrate.md
│   │   └── new-feature.md
│   ├── rules/             # Auto-loaded context rules
│   │   ├── bun-conventions.md
│   │   ├── testing.md
│   │   ├── deployment.md
│   │   └── security.md
│   ├── settings.json      # Plugins, permissions, hooks (shared)
│   └── settings.local.json.example
├── src/
│   ├── index.ts           # Bun.serve() entry point
│   ├── index.html         # HTML entry (Bun imports)
│   ├── app.tsx            # React root
│   ├── styles.css         # Global styles
│   ├── lib/               # Shared utilities
│   ├── routes/            # API route handlers
│   └── components/        # React components
├── scripts/
│   ├── migrate.ts         # Migration runner
│   └── migrations/        # Migration files
├── docs/
│   └── best-practices.md  # Team guide
├── .mcp.json              # MCP servers (context7, sequential-thinking)
├── CLAUDE.md              # Lean project context (~90 lines) with @imports
├── agents.md              # Agent usage guide (imported by CLAUDE.md)
├── Dockerfile             # Multi-stage Bun build for GCP Cloud Run
└── package.json           # Bun project config

Documentation

• CLAUDE.md — Project conventions Claude follows (lean, with @imports)
• agents.md — How to use Claude Code effectively (imported by CLAUDE.md)
• docs/best-practices.md — Team best practices, prompting patterns, rules/ examples, onboarding