@freewebstore/cli

Designer-side CLI for FreeWebStore. Scaffold an HTML+Tailwind template, vibecode the design, ship it to a small business website near you.

npx @freewebstore/cli init sofia-bistro --category=restaurant.italian
cd sofia-bistro
# vibecode index.html with Claude Code / Cursor / your editor of choice
# add a 1280×720 preview.png
npx @freewebstore/cli doctor    # local validation
npx @freewebstore/cli login     # one-time — opens browser to authorize
npx @freewebstore/cli publish   # upload + create repo + queue for review
npx @freewebstore/cli status sofia-bistro

Commands

Command	What it does
fws init <slug> --category=<c>	Scaffold a new template directory
fws doctor [--path=<dir>]	Validate the template locally before publish
fws login	Authorize via GitHub App (installs on your personal account)
fws logout	Clear local auth
fws whoami	Show current auth state
fws publish [--path=<dir>]	Upload the template for review
fws status <slug>	Check the status of a published template

How auth works

fws login opens your browser to install the FreeWebStore Templates GitHub App on your personal GitHub account. You do NOT need to be a member of the freewebstore-online org — the platform creates template repos in the org on your behalf when you fws publish.

What you get

• Clients find you. Businesses that outgrow their free site come to you for custom work — on FreeWebStore or full CMS builds on ProWebStore.
• Recognition. Every adopting site's footer credits you ("Template by @your-handle"), linked to your designer profile on freewebstore.online.
• Social proof. Live adoption counter on your designer page — updated daily.
• Portfolio. Permanent preview URL at templates.freewebstore.online/{slug}/. Share it, embed it, it doesn't expire.
• Zero cost. You volunteer the HTML; the platform handles hosting, deploy, AI customization, and client matching.

How customization works

You write index.html with Tailwind utility classes. Mark customization points with data-fws-slot="business.name" etc. (see slots.md in your scaffolded directory).

When a small business picks your template, the FreeWebStore platform AI rewrites the slot contents per business. No templating language, no build step — pure HTML in, pure HTML out, AI bridges both sides.

Environment variables

Var	Purpose
FREEWEBSTORE_CONFIG_DIR	Override ~/.freewebstore/ (useful in CI)
FREEWEBSTORE_ADMIN_BASE	Override admin Worker URL (useful for local dev / staging)