- 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>
67 lines
1.7 KiB
Markdown
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.
|