progressive-centralization-starter

Progressive Centralization Starter

Scaffold a new project

• bun run init -- --template page --dest ./my-page
• bun run init -- --template web3 --dest ./my-web3

Quick start (inside a template project)

1. bun install
2. cp .env.example .env
3. Fill .env
4. bun run default <template> (optional)
5. bun run build <template> (or bun run build if default set)
6. bun run deploy <template> (or bun run deploy if default set)
7. bun run preview <template> (optional)
8. bun run dev (local Anvil + deploy + build)

Configuration essentials

• Townsquare app: APP_CHAINS_JSON, APP_DEFAULT_CHAIN_ID, TOWNSQUARE_ADDRESSES_JSON
• Filebase IPFS: FILEBASE_BUCKET, FILEBASE_ROOT_KEY, FILEBASE_ROOT_SECRET
• ENS: ENS_NAME, PRIVATE_KEY, APP_CHAINS_JSON, ENS_CHAIN_ID (or ENS_RPC_URL), optional ENS_NAMEWRAPPER_ADDRESS
• Optional Arweave/ArNS: ARWEAVE_KEY / ARWEAVE_KEYFILE, ARNS_NAME or ARNS_PROCESS_ID

Deploy flags

• --dry-run (build + upload only)
• --skip-ens (skip ENS update)
• --cid <cid> (use an existing CID)
• --name <ens> (override ENS name)
• --no-resolver-switch (avoid auto-switching resolver)

Customize the frontend

• templates/<template>/src/main.ts: UI logic
• templates/<template>/src/styles.css: styles
• templates/<template>/src/template.html: metadata + placeholders
• templates/<template>/public/: optional static assets copied into dist/
• contracts/Townsquare.sol: on-chain template contract

Guardrails

• Use Bun for all commands; do not use npm or Node.
• Never commit .env or wallet keys.