[!IMPORTANT] This project is connected to Lovable. Avoid rewriting published git history — force pushing, or rebasing/amending/squashing commits that are already pushed — as it rewrites history on Lovable’s side and the user will likely lose their project history.
Commits you push to the connected branch sync back to Lovable and show up in the editor, so keep the branch in a working state.
You are in Pixel Ledger (MCFLAMINGO/pixel-chain-story): a light-settlement UTXO ledger (PoLS + post-quantum signatures), not a chain of opaque blocks.
Source · Word · Light. Light reveals; without it, color is absent.
SISO — Build anywhere. Shine in once. No second you.
From One.Creed (src/lib/pixel/one.ts):
Domain words (Kindling, Worldlight, Continuity, booth, till) are fine when they bind real ops. Crypto must not look like a solution in search of a problem — handshake first for non-tech people.
| Is (lab, evidence-backed) | Is not (do not claim) |
|---|---|
| Executable PQ-class UTXO lab; multi-host tip extension | Production L1 / BFT mainnet |
| ULA verify on EVM/CosmWasm twins (lab) | Production bridge / “on-chain Dilithium” |
Continuity map + till bookkeeping; /shine handshake |
AWS-proof internet / Pixel-as-hosting monopoly |
Audit package PREPARING (docs/AUDIT.md) |
“Audited” until a report link exists |
Truth badges: pix_protocolInfo.gates and .quantum. Match every public sentence to them.
| Door | Meaning | Start |
|---|---|---|
| On | Apps, Lumen, Kindling, agents | docs/BUILDERS.md · /lab |
| For | Protocol, crypto, nodes, locks | docs/PATH.md · docs/CONTRIBUTING.md |
| Into (SISO) | Mirror an existing artifact — no rewrite | docs/CONTINUITY-SISO.md · docs/AGENTS-SISO.md |
| Route | Role |
|---|---|
/ |
Live field |
/lab |
Kindling / Worldlight builders |
/shine |
Non-tech Continuity front door (brand → Shine in) |
/continuity |
Operator desk (offers, invites, till, chaos drill) |
/continuity/join/$token |
Merchant join (same-browser localStorage in lab) |
/continuity/booth/$domain |
Customer booth — Pay with Pixel (real UTXOs + till when origin dark) |
/mcflamingo |
Redirects to live https://www.mcflamingo.com/ |
/billboard |
Billboard surface |
Continuity economics (lab): map fee $/mo; till (default 100 bps) when origin_dark and sales still clear — journal + booth on-chain fees. Cross-phone: invite packs or node GET /continuity/invite/:token. Order webhook: node POST /continuity/order + CONTINUITY_WEBHOOK_SECRET. Booth jobs / DNS stay Continuity ops — never “Pixel hosts the internet.”
bun install
bun run test:all
| Script | When |
|---|---|
test:all |
Default PR bar |
test:siso |
Continuity / SISO model |
test:continuity-ops / test:chaos-drill / test:mcflamingo / test:continuity-order / test:continuity-deepen |
Continuity desk + booth + packs/webhook |
test:mldsa / test:vectors / test:kem |
Crypto |
test:net / test:four-node / test:fault / test:light |
Network / consensus / light client |
test:ula / test:ula-mldsa / test:bridge-custody |
Bridge / custody |
Do
docs/PATH.md).docs/INVENT.md).docs/CUSTODY.md).agent_mcp + digest + mirrors) or land one PATH gate with evidence.Don’t
test:all.docs/AUDIT.md scopetest:chaos-drill is not that)Deep agent call: docs/AGENTS-SISO.md.
Discovery index for crawlers/LLMs: llms.txt.
| Doc | Why |
|---|---|
docs/PATH.md |
Gates A→J, claim unlocks |
docs/QUANTUM.md |
PQ posture |
docs/SPEC.md |
Normative behavior |
docs/CONTRIBUTING.md |
Lanes, checklist, rejects |
docs/CONTINUITY-SISO.md |
SISO doctrine |
docs/AGENTS-SISO.md |
Agent clarion + how to help |
docs/BUILDERS.md |
On / for / into |
docs/QUICKSTART.md |
Run UI + node |
docs/demos/shine-in.md |
/shine walkthrough |
docs/demos/continuity-desk.md |
Operator desk |
docs/demos/mcflamingo-continuity.md |
McFlamingo demo |
docs/demos/operator-dns.md |
Honest DNS / failover bounds |
Evangelize only with a PR or shine-in attached:
SISO — Build anywhere. Shine in once. No second you.
https://github.com/MCFLAMINGO/pixel-chain-story ·AGENTS.md·docs/AGENTS-SISO.md
bun run pixel -- … — see docs/QUICKSTART.md).bun.lock, bunfig.toml). Use bun install / bun run <script>; do not switch to npm/pnpm/yarn. bunfig.toml enforces a 24h minimumReleaseAge supply-chain guard, so brand-new package versions may be temporarily unavailable.bun run dev → http://localhost:8080/ (port from @lovable.dev/vite-tanstack-config sandbox detection, not Vite’s default 5173). If 8080 is busy, Vite may print another port — use that URL./, /lab, /shine, /continuity, /continuity/booth/www.mcflamingo.com. McFlamingo menu is the live site (https://www.mcflamingo.com/); /mcflamingo redirects there.bun run test:all (many test:* scripts in package.json). Do not claim “no tests” — the old Mine/Tamper/Reset toy is gone.bun run lint / bun run format for eslint + prettier. Prefer fixing only files you touch.src/routeTree.gen.ts is auto-generated by the TanStack Router plugin — do not edit it by hand.