Skip to content

Add docs/ARCHITECTURE.md mapping the codebase + catalog data flow#5

Open
VisionaireLabs wants to merge 1 commit into
masterfrom
docs/architecture
Open

Add docs/ARCHITECTURE.md mapping the codebase + catalog data flow#5
VisionaireLabs wants to merge 1 commit into
masterfrom
docs/architecture

Conversation

@VisionaireLabs
Copy link
Copy Markdown
Collaborator

Summary

  • New docs/ARCHITECTURE.md mapping the Next.js app layout, catalog data flow (lib/skills.ts + lib/skillsSh.ts + lib/clawhub.ts), Supabase tables and RLS posture, Stripe Checkout + webhook flow, env vars, and the weekly ClawHub stats refresh action.
  • Docs only. No source or behavior changes.

Notes

  • Verified accurate against the current code (App Router routes, STRIPE_PRICES SKUs, 00010003 migrations, the Refresh ClawHub stats workflow, lib/llms.ts ISR cadence).
  • npm run lint reports 2 errors + 3 warnings on this branch — identical to master (app/buy/success/page.tsx, app/glossary/page.tsx, app/page.tsx). Not introduced here.
  • npm run build fails locally with supabaseUrl is required because the build collects API routes that read NEXT_PUBLIC_SUPABASE_URL; Vercel sets it from project env. No code touched, so deploy behavior is unchanged.

Closes SOL-1.

Test plan

  • Render docs/ARCHITECTURE.md on GitHub and skim — headings, tables, code blocks display cleanly.

Documents the Next.js layout, catalog data flow (originals + curated
listings + skills.sh + ClawHub), Supabase tables and RLS posture,
Stripe checkout + webhook flow, env vars, and build/deploy through
Vercel. Docs only — no source or behavior changes.

Co-authored-by: multica-agent <github@multica.ai>
@vercel
Copy link
Copy Markdown

vercel Bot commented May 30, 2026

The latest updates on your projects. Learn more about Vercel for GitHub.

Project Deployment Actions Updated (UTC)
solidstate.cc Error Error May 30, 2026 10:22am

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant