template-standalone

The standalone-app template used by fas init to scaffold new free apps for FreeAppStore.

You almost certainly want to use the CLI, not clone this directly:

npm i -g @freeappstore/cli
fas init my-app

The CLI clones this template, replaces every freeappstore placeholder with your app id, runs git init, and makes the first commit — the result is a runnable app you can pnpm dev immediately.

What's in here

• web/ — Vite + React + TypeScript app, ESM-only, no Tailwind config needed (utility classes via inline styles + the Shell component).
• web/src/components/Shell.tsx — sidebar layout with brand fonts (Manrope + Fraunces), CSS variables (--paper, --ink, --accent), and dark-mode support out of the box.
• web/src/main.tsx — React entry point.
• web/index.html — links Manrope + Fraunces, sets PWA meta tags, references the manifest.
• web/public/manifest.json — PWA manifest with name, display, start_url.
• package.json — pnpm workspace, dev / build / typecheck / test scripts.
• .github/workflows/compliance.yml — runs the same checks as fas check on every PR. Source of truth lives in the @freeappstore/compliance package.

Cloning manually (not recommended)

If you really want to scaffold by hand:

git clone https://github.com/freeappstore-online/template-standalone my-app
cd my-app
# Replace freeappstore → my-app in package.json, web/index.html, web/src/main.tsx, README, etc.
rm -rf .git && git init
pnpm install && pnpm dev

Then run fas publish to provision repo + hosting + DNS, or open the submission form for maintainer review.

License

MIT.