.PHONY: help setup setup-symlinks install build build-desktop build-android build-ios clean run dev doctor doctor-q docker-up docker-down docker-nuke docker-status thunderbot-pull thunderbot-push thunderbot-customize

BLUE := \033[0;34m

GREEN := \033[0;32m

YELLOW := \033[0;33m

NC := \033[0m # No Color

help:

@echo "Available commands:"

@echo " make setup - Install frontend and backend dependencies"

@echo " make install - Install frontend dependencies"

@echo " make run - Start both backend and frontend development servers"

@echo " make dev - Alias for 'make run'"

@echo " make build - Build frontend for production"

@echo " make build-desktop - Build Tauri desktop app"

@echo " make build-android - Build Tauri Android app"

@echo " make build-ios - Build Tauri iOS app"

@echo " make clean - Clean build artifacts"

@echo " make format - Format frontend, backend (JS/TS), and Rust code"

@echo " make format-check - Check formatting for frontend, backend, and Rust code"

@echo " make doctor - Verify all dev tools and env files are configured"

@echo " make docker-up - Start docker containers (PowerSync, Mongo, etc.)"

@echo " make docker-down - Stop docker containers"

@echo " make docker-nuke - Destroy all docker data and recreate from scratch"

@echo " make docker-status - Show docker container status"

@echo " make thunderbot-pull - Pull latest skills from thunderbot"

@echo " make thunderbot-push - Push skill changes back to thunderbot"

@echo " make thunderbot-customize - Fork a thunderbot command for local edits (FILE=name.md)"

@echo " make setup-symlinks - Create agent symlinks for Claude Code"

setup-symlinks:

@mkdir -p .claude/commands .claude/agents

@for f in .thunderbot/thunder*.md; do ln -sf "../../$$f" ".claude/commands/$$(basename $$f)"; done

@ln -sfn ../../.thunderbot/thunderbot .claude/commands/thunderbot

@ln -sf ../../.thunderbot/thunderbot.md .claude/agents/thunderbot.md

@echo "$(GREEN)✓ Agent symlinks configured$(NC)"

setup: setup-symlinks

@echo "$(BLUE)→ Installing frontend dependencies...$(NC)"

bun install

@echo "$(BLUE)→ Installing backend dependencies...$(NC)"

cd backend && bun install

@echo "$(GREEN)✓ Setup complete!$(NC)"

install:

bun install

build:

bun run build

build-desktop:

bun install

bun tauri build

build-desktop-target:

bun install

bun tauri build --target $(TARGET)

build-desktop-full:

bun install

bun tauri build --bundles $(BUNDLES) --target $(TARGET)

build-android:

bun install

bun tauri android build

build-ios:

bun install

bun tauri ios build --export-method app-store-connect

clean:

- rm -rf dist src-tauri/target node_modules

- (cd src-tauri && cargo clean)

lint:

bun run lint

lint-fix:

bun run lint:fix

format:

@echo "$(BLUE)→ Formatting frontend code...$(NC)"

bun run format

@echo "$(BLUE)→ Formatting backend code...$(NC)"

cd backend && bun run format

@echo "$(BLUE)→ Formatting Rust code...$(NC)"

bun run format:rust

@echo "$(GREEN)✓ Formatting complete!$(NC)"

format-check:

@echo "$(BLUE)→ Checking frontend formatting...$(NC)"

bun run format-check

@echo "$(BLUE)→ Checking backend formatting...$(NC)"

cd backend && bun run format-check

@echo "$(BLUE)→ Checking Rust formatting...$(NC)"

bun run format:rust-check

@echo "$(GREEN)✓ Format check complete!$(NC)"

type-check:

bun run type-check

test:

@echo "$(BLUE)→ Running frontend tests...$(NC)"

@bun test || echo "$(YELLOW) No frontend tests found$(NC)"

@echo "$(BLUE)→ Running backend tests...$(NC)"

@cd backend && bun test

check:

bun run check

run:

@echo "$(BLUE)→ Starting backend and frontend development servers...$(NC)"

@echo "$(YELLOW) Backend will run on http://localhost:8000$(NC)"

@echo "$(YELLOW) Frontend will run on http://localhost:5173$(NC)"

@echo "$(YELLOW) Press Ctrl+C to stop both servers$(NC)"

@echo ""

@# Kill any existing processes on the ports first

@-lsof -ti:8000 | xargs kill -9 2>/dev/null || true

@-lsof -ti:5173 | xargs kill -9 2>/dev/null || true

@# Start backend in background and frontend in foreground

cd backend && bun run dev & \

BACKEND_PID=$$!; \

echo "$(GREEN)✓ Backend started (PID: $$BACKEND_PID)$(NC)"; \

sleep 2; \

bun run dev || (kill $$BACKEND_PID 2>/dev/null && exit 1)

dev: run

doctor:

@bash scripts/thunderdoctor.sh

doctor-q:

@bash scripts/thunderdoctor.sh --quiet

docker-up:

@echo "$(BLUE)→ Starting docker containers...$(NC)"

docker compose -f powersync-service/docker-compose.yml up -d

@echo "$(GREEN)✓ Docker containers started!$(NC)"

docker-down:

@echo "$(BLUE)→ Stopping docker containers...$(NC)"

docker compose -f powersync-service/docker-compose.yml down

@echo "$(GREEN)✓ Docker containers stopped!$(NC)"

docker-nuke:

@bash scripts/docker-nuke.sh

docker-status:

@bash scripts/docker-status.sh

thunderbot-pull:

@echo "$(BLUE)→ Pulling latest skills from thunderbot...$(NC)"

git subtree pull --prefix=.thunderbot thunderbot main --squash

@$(MAKE) setup-symlinks

@echo "$(GREEN)✓ Skills updated!$(NC)"

thunderbot-push:

@echo "$(BLUE)→ Pushing skill changes to thunderbot...$(NC)"

git subtree push --prefix=.thunderbot thunderbot main

@echo "$(GREEN)✓ Skills pushed!$(NC)"

thunderbot-customize:

@if [ -z "$(FILE)" ]; then echo "Usage: make thunderbot-customize FILE=thunderfix.md"; exit 1; fi

@if [ ! -L ".claude/commands/$(FILE)" ]; then echo "$(YELLOW).claude/commands/$(FILE) is not a symlink — already customized or doesn't exist$(NC)"; exit 1; fi

@rm ".claude/commands/$(FILE)" && cp ".thunderbot/$(FILE)" ".claude/commands/$(FILE)"

@echo "$(GREEN)✓ .claude/commands/$(FILE) is now a local copy — edit freely$(NC)"