CLI Commands Reference

Complete reference for pnpm scripts, Wrangler commands, and common operations.

pnpm Scripts

From package.json:

Development

pnpm dev              # Start Vite dev server (localhost:5173)
pnpm wrangler:dev     # Start Wrangler dev server (Workers environment)
pnpm preview          # Preview production build

Build

pnpm build            # Build for production
pnpm prepare          # Generate SvelteKit types

Testing

pnpm test             # Run all tests once
pnpm test:unit        # Run tests in watch mode
pnpm check            # TypeScript type checking
pnpm check:watch      # Type checking in watch mode

Code Quality

pnpm format           # Format all files with Prettier
pnpm lint             # Run ESLint

Database

pnpm db:generate      # Generate migration from schema
pnpm db:migrate       # Apply migrations
pnpm db:push          # Push schema directly (dev only)
pnpm db:studio        # Open Drizzle Studio

Deployment

pnpm deploy           # Build and deploy to Cloudflare
pnpm wrangler:deploy  # Deploy with Wrangler
pnpm wrangler:login   # Login to Cloudflare

Wrangler Commands

Deployment

# Deploy to specific environment
npx wrangler deploy --env development
npx wrangler deploy --env staging
npx wrangler deploy --env production

# List recent deployments
npx wrangler deployments list --env production

# Rollback deployment
npx wrangler rollback --env production

Secrets Management

# Set secret
echo "value" | npx wrangler secret put SECRET_NAME --env production

# Delete secret
npx wrangler secret delete SECRET_NAME --env production

# List secrets
npx wrangler secret list --env production

Logs

npx wrangler tail --env production                  # Tail logs
npx wrangler tail --env production --status error   # Filter by status

Development

# Run locally with Workers runtime
npx wrangler dev

# Run with specific environment
npx wrangler dev --env development

Database Commands

PostgreSQL

# Connect to database
psql $WRITE_DATABASE_URL

# Run SQL file
psql $WRITE_DATABASE_URL -f migration.sql

# Dump database
pg_dump $WRITE_DATABASE_URL > backup.sql

# Restore database
psql $WRITE_DATABASE_URL < backup.sql

Drizzle Kit

# Generate migration
npx drizzle-kit generate

# Generate custom migration
npx drizzle-kit generate --custom --name=my_migration

# Apply migrations
npx drizzle-kit migrate

# Open Drizzle Studio
npx drizzle-kit studio

AWS CLI

SSM Parameters

# Get parameter
aws ssm get-parameter \
  --profile ref-dev \
  --name "/app-web/dev/AUTH_SECRET" \
  --with-decryption

# Put parameter
aws ssm put-parameter \
  --profile ref-dev \
  --name "/app-web/dev/NEW_PARAM" \
  --value "value" \
  --type "SecureString"

# List parameters
aws ssm get-parameters-by-path \
  --profile ref-dev \
  --path "/app-web/dev/" \
  --recursive

Git Commands

Branch Management

# Create feature branch
git checkout -b feature/my-feature

# Update from main
git checkout main
git pull origin main
git checkout feature/my-feature
git rebase main

# Push branch
git push origin feature/my-feature

Commit

# Stage and commit
git add .
git commit -m "feat: add new feature"

# Amend last commit
git commit --amend -m "feat: updated message"

Custom Scripts

Fetch Environment Variables

# Development
./scripts/fetch-ssm-params.sh dev .dev.vars

# Staging
./scripts/fetch-ssm-params.sh staging .staging.vars

# Production
./scripts/fetch-ssm-params.sh production .prod.vars

Upload Secrets to Cloudflare

./scripts/bulk-upload-secrets.sh \
  app-web-production \
  .prod.vars \
  "$CLOUDFLARE_API_TOKEN" \
  "$CLOUDFLARE_ACCOUNT_ID"

Related Documentation

• Configuration Reference

• Local Development

• Deployment Guide

---

Last updated: October 2025