{"path":"docs/ARCHITECTURE.md","size":1861,"locked":false,"binary":false,"truncated":false,"content":"# Architecture (v1 / MVP)\n\n```\nGitHub push\n     |\n     v\nBuild runner (manual CLI run today; GitHub webhook trigger is a Week 3 item)\n     |  detect framework -> run build command\n     v\nStoracha (IPFS pinning)\n     |  uploadDirectory(buildOutput) -> CID\n     v\nSNS record write\n     |  IPFS.<domain> record <- CID   (V1 format; see lib/sns.js for V2 status)\n     v\nResolution\n     yourdomain.sol -> CID -> IPFS gateway\n     (resolved by Brave Browser, sol-domain.org, etc. — Anchr doesn't run its own resolver)\n```\n\n## Components\n\n| Piece | Status | Notes |\n|---|---|---|\n| Framework detection | Done (MVP) | Vite, Next.js (static export), CRA |\n| Build execution | Done (MVP) | Runs the detected `npm run build` |\n| IPFS pinning | Done (MVP) | Storacha only; multi-provider deferred |\n| SNS record write | Done (MVP, V1) | V2 write pending SDK source verification |\n| Dashboard (status + preview link) | Planned — Week 3 | Not yet built |\n| GitHub webhook trigger | Planned — Week 3 | `deploy.yml` is manual-trigger only until then |\n| ENS / Unstoppable Domains | Deferred (v2+) | Not started |\n| Multi-provider pinning | Deferred (v2+) | Not started |\n\n## Why SNS-first\n\nSpheron Network — the obvious \"this already exists\" competitor — retired its\nstorage/hosting product in May 2024 to pivot into GPU/DePIN compute, leaving\na real gap. Fleek remains the main active multi-chain competitor. Anchr's\nwedge is narrower and deeper: SNS-first, Solana-native, rather than trying to\nmatch Fleek's full chain breadth on day one.\n\n## Prior art\n\n`Bonfida/sns-deploy` (2021) did something similar — Infura pinning, raw\nwallet.json path, no CI integration, no framework detection. Anchr's\ndifferentiation is a modern pinning provider (Storacha/UCAN), automatic\nframework detection, and a CI-friendly credential model built around a\nGitHub-push deploy flow.\n"}