Deploy a Full‑Stack Web App with a Single PinMe Command (and a Powerful AI Skill)

Problem: Full‑stack deployment friction

Full‑stack delivery typically requires separate steps for front‑end build, serverless/Worker backend provisioning, and database migration synchronization. Any blockage in one step can turn the "last mile" into a "last hundred miles" of friction.

PinMe overview

PinMe is an npm‑distributed CLI ( npm install -g pinme) that automates the creation, build, and deployment of a front‑end, a Worker‑based backend, and a D1‑like database. It consolidates authentication, resource creation, configuration, dependency installation, building, and uploading into repeatable commands.

One‑command workflow

npm install -g pinme
pinme login
pinme create my-app
cd my-app
pinme save

The create command performs authentication, creates platform resources, writes pinme.toml, installs dependencies, builds the Worker, uploads the Worker and SQL migrations, builds the front‑end, and uploads the assets, completing the "first‑time" setup.

Environment requirements

Node.js version >= 16.13.0 is required. After installation, run pinme --version to verify readiness.

Save and layered updates

Running pinme save in the project root (containing pinme.toml) executes the full chain: dependency installation, Worker build, db/ SQL upload, front‑end build, and upload of frontend/dist. An optional --domain flag can bind a custom domain.

For incremental changes, PinMe provides separate commands: pinme update-worker – rebuilds and uploads only the Worker. pinme update-db – uploads only the db/ migration files. pinme update-web – rebuilds and uploads only the front‑end assets.

This design aligns the scope of changes with deployment cost, avoiding full‑bundle redeploys.

Static‑only upload shortcut

When only static assets need hosting, after pinme login run pinme upload dist (or build, out, public, etc.). The README warns against uploading source directories such as src, node_modules, .git, or .env for security and compliance reasons.

Claude Code skill support

PinMe explicitly supports Claude Code Skills. Install the skill with: npx skills add glitternetwork/pinme The skill enables AI agents to follow the same workflow—choosing project mode or static upload, retrieving the final URL, and executing required commands in the directory containing pinme.toml —by reading the "For AI Agents" section in README.md.

Repository

Source code and documentation are available at https://github.com/glitternetwork/pinme