agentsclimarketplace

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

Install
npx -y skills add falkcorp/audiobook-organizer --skill build-deploy

Assembled 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 install exits 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

TargetFrontendBackendSpeedUse Case
make build✓ Build✓ EmbedSlowerDeployment, distribution
make build-api✗ Skip✓ BuildFasterLocal 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:

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 (or make web-dev if frontend-focused)
  • "Run tests" → make test-short (or make test-all for full)
  • "Deploy" → make deploy
  • "I need the frontend" → make web-dev (live editing)

Keep looking

Skills are one crate of 609,856. Ordering is by how many stacks a row turns up in, so the top of any crate is what has actually been picked rather than what has the most stars.