Build deploy
Skill falkcorp/audiobook-organizer/.claude/skills/build-deploy
Build and deploy the audiobook-organizer using Makefile targets. Handles full builds (frontend + backend), API-only builds, test runs, and deployment. Always uses `make` targets instead of manual commands; auto-installs frontend dependencies before builds. Use when asked to build, run, test, deploy, or for frontend dev server.From its SKILL.md
npx -y skills add falkcorp/audiobook-organizer --skill build-deployAssembled from the repository path, not quoted from the project. Check it against their README if it does not work.
2 things to look at
- no licenseNo license file was found in the repository. Code published without one is not open source by default, so using it at work is a question for whoever answers licensing questions where you are.
- 3 stars3 stars. Stars are a popularity signal and not a quality one, but at this level it is likely that nobody has read this closely except its author, and you would be relying on your own review.
SKILL.md
3.6 KB, as published. Nobody here has run it
Build & Deploy
Wraps the Makefile build system, ensuring consistent builds and preventing common mistakes (forgetting frontend location, missing npm install, using wrong targets).
Quick Start
Common commands:
make build # Full build: frontend + Go backend (embedded UI)
make build-api # Backend only (faster iteration)
make run # Full build then serve (http://localhost:8484)
make run-api # Backend-only build then serve
make test-short # Quick tests (skip slow prop tests)
make test-all # All tests (backend full + frontend)
make web-dev # Vite dev server (http://localhost:5173)
make deploy # Full build + deploy to production
make deploy-debug # Build with debug symbols then deploy
Key Points
Frontend location: repo_root/web/ (Vite project)
Dependencies: make build and make web-build automatically run npm install in web/ before building. This ensures:
- No "missing dependency" surprises
- Minor version updates don't break the build
- Fast path:
npm installexits instantly if package.json hasn't changed
Embedded UI: Default make build embeds the React frontend into the Go binary (tag embed_frontend). This creates a single self-contained binary served on :8484. For frontend development, use make web-dev (separate Vite server on :5173).
Build Variants
| Target | Frontend | Backend | Speed | Use Case |
|---|---|---|---|---|
make build | ✓ Build | ✓ Embed | Slower | Deployment, distribution |
make build-api | ✗ Skip | ✓ Build | Faster | Local API iteration |
make run | ✓ Build | ✓ Run | — | One-step dev |
make run-api | ✗ Skip | ✓ Run | — | Backend-only dev |
make web-dev | ✓ Live | ✗ Skip | — | Frontend dev (Vite HMR) |
Testing
make test # Full backend tests (~15 min, includes property tests)
make test-short # Fast backend tests (~1 min, skips property tests)
make test-all # Backend (full) + frontend tests
make test-all-short # Backend (-short) + frontend tests
make test-frontend # Frontend tests only
make test-e2e # Playwright end-to-end tests
Deployment
make deploy # Build + deploy to production (requires Makefile.local)
make deploy-debug # Build with debug symbols + deploy
Deploy targets are defined in Makefile.local (not in the main Makefile). They handle:
- Go build with versioning
- Frontend build
- Upload to production server
- Service restart
See references/makefile-targets.md for full target list and options.
Frontend Development
For React/TypeScript work, use the Vite dev server:
make web-dev
Then:
- Open http://localhost:5173
- Edit
web/src/**/*.tsx→ changes appear instantly (HMR) - Backend API available at http://localhost:8484 (adjust in vite.config.ts if needed)
To test the embedded UI (after make build):
./audiobook-organizer
# Open http://localhost:8484
When to Use This Skill
"Build the backend"→make build-api"Run the app"→make run(ormake web-devif frontend-focused)"Run tests"→make test-short(ormake test-allfor full)"Deploy"→make deploy"I need the frontend"→make web-dev(live editing)