Skip to content

docs: add a Deployment section to the README - #1

Open
cayvox wants to merge 1 commit into
mainfrom
docs/deployment-readme
Open

docs: add a Deployment section to the README#1
cayvox wants to merge 1 commit into
mainfrom
docs/deployment-readme

Conversation

@cayvox

@cayvox cayvox commented Jul 31, 2026

Copy link
Copy Markdown
Contributor

Adds a Deployment section to the README describing the static production recipe, mirroring the live PartyLayer demo app.

What it covers:

  • Static Vite build: npm run build (tsc then vite build) emits static assets to dist/.
  • Deploy dist/ to any static host (Caddy, Nginx, Netlify, Vercel static, GitHub Pages, S3 plus CDN). No server runtime is required for the app.
  • SPA fallback: rewrite unknown paths to /index.html (Caddy try_files {path} /index.html, the Nginx try_files equivalent, and a Netlify/Vercel catch-all), otherwise deep links 404.
  • Live data: the build runs the in-browser demo backend by default. Live wiring is done by replacing the demo backend fetchers per the existing Real mode section (this template reads no backend env vars, so none are named).
  • SEO and icon assets: the template ships no public/ directory, so a production deploy should add a robots.txt allowing indexing, a sitemap.xml, and a favicon set. Vite serves anything under public/ at the site root.

Every claim was verified against the repo: the package.json build script, the absence of a public/ directory and a .env.example, no env usage in src/, and the default Vite dist output.

Scope: README-only, 44 insertions. No em or en dashes were introduced. A scan of the existing README came back clean, so no dash fixes were needed.

Opening for review, not merging.

Signed-off-by: anilkaracay <anilkaracayy@gmail.com>
Co-authored-by: Cayvox Labs <info@cayvox.com>
Co-authored-by: anilkaracay <anilkaracayy@gmail.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants