Files
Mikael BergandPaperclip eb156ab146 fix: address CTO review notes — Loops env var clarity + NFS build doc
- README: clarify NEXT_PUBLIC_LOOPS_FORM_ID is required and that omitting
  it produces a broken (404ing) form, not a graceful degradation
- docs/deploy.md: add Local Build Notes section explaining the config.cache=false
  NFS workaround, the ~15s penalty, and the two-run fallback

Co-Authored-By: Paperclip <noreply@paperclip.ing>
2026-05-20 14:32:09 +00:00

67 lines
1.7 KiB
Markdown

# using.cash — marketing website
BCH-native accounting SaaS marketing site. Next.js 15 static export, served via nginx.
## Local development
```bash
npm install
npm run dev
# Opens at http://localhost:3000
```
## Build (static export)
```bash
cp .env.example .env.local
# Edit .env.local — set NEXT_PUBLIC_LOOPS_FORM_ID
npm run build
# Static output written to ./out/
```
## Docker
Build:
```bash
docker build \
--build-arg NEXT_PUBLIC_LOOPS_FORM_ID=your_loops_form_id \
-t using-cash-web .
```
Run:
```bash
docker run -p 8080:8080 using-cash-web
# Site available at http://localhost:8080
```
## Environment variables
| Variable | Required | Description |
|---|---|---|
| `NEXT_PUBLIC_LOOPS_FORM_ID` | **Required** | Loops publishable form ID. Baked into the static HTML at `npm run build` time. Without it the waitlist form submit will 404 — the build succeeds but the deployed form is broken. Always set this before building for production. |
## Pages
| Route | File |
|---|---|
| `/` | `src/app/page.tsx` |
| `/product` | `src/app/product/page.tsx` |
| `/pricing` | `src/app/pricing/page.tsx` |
| `/about` | `src/app/about/page.tsx` |
| `/waitlist` | `src/app/waitlist/page.tsx` |
| `/blog` | `src/app/blog/page.tsx` |
| `/legal/privacy` | `src/app/legal/privacy/page.tsx` |
| `/legal/terms` | `src/app/legal/terms/page.tsx` |
RSS feed: `/blog/rss.xml` (static file at `public/blog/rss.xml`).
## Team portraits
Team grid is driven by `src/data/agents.json`. Each entry has a `portrait` field (currently `null` — renders initials placeholder). Swap in a URL to display the portrait with no layout changes needed.
## Deploy
See `docs/deploy.md` for k8s + DNS cutover runbook.