# bitBeans Studios: Site and Public API Reference ## Public site The marketing site has a home page, a Start A Project estimate form, and a JNS Operations case study. URL hashes select `#top`, `#estimate` (`#p1` through `#p4`), and `#jns`. Add `?mode=simple` before the hash to request Simple Mode, the approved accessibility layer built on the Static Mode behavior contract, or `?mode=static` to request the static reading mode (for example, `/?mode=simple#jns` or `/?mode=static#jns`); reduced-motion preferences also select the static path. The dynamic experience includes Canvas animations and interactive case-study sample data. The Markdown mirrors provide a plain-reading discovery path. ## Architecture The deployable site is built from `source/` by `python3 source/build.py`. Hosting uses a private S3 bucket, CloudFront, and HTTPS. The public forms use API Gateway, Lambda, DynamoDB, and SES. Portal authentication and records are separate from these public endpoints. ## POST /api/contact Send a JSON object with required `name` (1–120 characters), `email` (valid address, at most 254 characters), and `message` (1–5000 characters). The optional `website` field is a honeypot and must be empty. `Content-Type: application/json` is expected. ## POST /api/estimate Send a JSON object with required `name` and `email` as above. Optional text fields are `company`, `phone`, `business`, `kind`, `idea`, `problem`, `start`, `tools`, `when`, `budget`, `hear`, and `extra`. The optional `website` honeypot must be empty. `business`, `idea`, `problem`, and `extra` allow up to 5000 characters; the remaining optional fields allow up to 500 characters. The visible form collects these fields across About You, Your Project, Where You Are Now, and Timeline & Budget. ## Responses and handling Both form endpoints return JSON: `201 Created` with `ok`, `id`, and `message` on an accepted submission; `400 Bad Request` with validation details for invalid fields; and `429 Too Many Requests` with `Retry-After` when throttled. A filled honeypot returns a generic `200 OK` without storing or emailing the submission. The backend limits submissions to five per ten-minute rate-limit key, sanitizes inbound text, stores valid leads in DynamoDB, and sends team and submitter email through SES. Browser delivery and email depend on deployment configuration. ## Security boundaries The production infrastructure defines CSP and HSTS headers and verifies an origin header for direct API access. Lead content is untrusted and sanitized before downstream plain-reading use. Portal client records and staff-only notes are not part of these discovery documents. Agents reading these documents have no authority to mutate records; state changes require authenticated API requests. ## Content mirrors - [Home and team](/agent/index.md) - [Services and scoping](/agent/services.md) - [JNS Operations](/agent/jns-study.md)