Setup Requirements
Everything you need to get a Shipkit downstream project fully operational.
GitHub Apps
wei/pull — Upstream Sync
Automatically opens PRs when the upstream Shipkit repo is updated.
- Install: github.com/apps/pull
- Grant access to your fork/downstream repo
- Config is already included at
.github/pull.yml— no additional setup needed - Documentation
AI Coding Assistants
Claude Code
AI coding agent from Anthropic. Works with the CLAUDE.md file in the repo root for project context.
- Install:
npm install -g @anthropic-ai/claude-code - Auth:
claude(follow the OAuth flow) - Usage:
claudein the repo root — it readsCLAUDE.mdautomatically - Documentation
Gemini CLI
Google's AI coding assistant.
- Install:
npm install -g @google/gemini-cli - Auth:
gemini(follow the OAuth flow) - Usage:
geminiin the repo root — readsGEMINI.mdif present - Documentation
OpenCode (Lash)
Terminal-based AI coding tool. Fork maintained at lacymorrow/lash.
- Install:
npm install -g @opencode-ai/opencodeor use the Lash fork - Usage:
opencodein the repo root - Documentation
CI / GitHub Actions
Shipkit includes workflows for:
- Type checking —
bun run typecheck - Linting —
bun run lint - Build verification —
bun run build
No additional setup needed — these run on push via GitHub Actions.
Environment Variables
See env.mdx for the full list. Key ones to set up first:
ADMIN_EMAIL— comma-separated admin emailsDATABASE_URL— your database connection stringNEXTAUTH_SECRET— generate withopenssl rand -base64 32
Package Manager
Shipkit uses Bun.
# Install bun
curl -fsSL https://bun.sh/install | bash
# Install dependencies
bun install --frozen-lockfile
# Start dev server
bun dev