chore: scaffold PYRE MVP monorepo (structure + docs)

pnpm + TypeScript workspace per design doc §13:
- apps/{web,api,worker} skeletons (Next.js 16, Fastify 5, BullMQ)
- packages/{core,solana,prometheus,db,config} (core has real types/DTOs;
  solana/prometheus are stubs)
- programs/pyre-core placeholder (future Anchor, v1.0)
- docs/: PYRE_MVP_DESIGN (canonical), ARCHITECTURE, SECURITY, TOKEN_CLASSIFICATION
- CLAUDE.md, README, .env.example (no private-key var by design)

Skeleton + docs only — no Solana/business logic yet. All workspaces typecheck clean.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>

apps/web/README.md

@@ -0,0 +1,43 @@
+# @pyre/web
+
+User-facing PYRE web app. **Skeleton only** — no wallet or business logic is
+implemented yet (see [`CLAUDE.md`](../../CLAUDE.md) and §13 of the design doc).
+
+Stack: Next.js (App Router) + TypeScript + Tailwind + Solana Wallet Adapter +
+React Query.
+
+## Responsibilities (§13)
+
+- Landing page
+- Wallet connect (Solana Wallet Adapter)
+- Scanner UI — display token accounts and classification grouping
+- Cleanup preview — accounts to close, tokens to burn, rent returned, fees,
+  warnings, rent destination (decode tx and match against preview before signing)
+- Receipt page — tx signature, accounts closed, tokens burned, rent returned,
+  skipped accounts
+- Prometheus generation preview — Spawn name/ticker/lore/image-prompt review
+- Admin review page — approve/reject generated Spawn packages
+
+## Trust rules (do not weaken)
+
+- PYRE never holds private keys; all signing is client-side in the user's wallet.
+- Always show a preview and match the decoded transaction against it before
+  requesting a signature.
+- Recovered ATA rent returns to the user by default.
+
+## TODO
+
+- [ ] Tailwind + PostCSS config and global styles
+- [ ] WalletAdapter / React Query providers
+- [ ] Scanner page wired to `POST /api/scan`
+- [ ] Cleanup preview + transaction decode/match UI
+- [ ] Sign flow via wallet adapter
+- [ ] Receipt page wired to `POST /api/receipt`
+- [ ] Prometheus generation preview + admin review pages
+
+## Scripts
+
+- `dev` — `next dev`
+- `build` — `next build`
+- `typecheck` — `tsc --noEmit`
+- `lint` / `test` — placeholders for now

apps/web/package.json

@@ -0,0 +1,34 @@
+{
+  "name": "@pyre/web",
+  "version": "0.1.0",
+  "private": true,
+  "type": "module",
+  "description": "PYRE web app — Next.js user-facing UI: landing, wallet connect, scanner, cleanup preview, receipt, Prometheus preview, admin review.",
+  "scripts": {
+    "build": "next build",
+    "dev": "next dev",
+    "typecheck": "tsc --noEmit",
+    "lint": "echo \"TODO: lint\"",
+    "test": "echo \"TODO: tests\""
+  },
+  "dependencies": {
+    "@pyre/core": "workspace:*",
+    "@solana/wallet-adapter-react": "^0.15.39",
+    "@solana/wallet-adapter-react-ui": "^0.9.39",
+    "@solana/wallet-adapter-wallets": "^0.19.38",
+    "@solana/web3.js": "^1.98.4",
+    "@tanstack/react-query": "^5.100.0",
+    "next": "^16.2.6",
+    "react": "^19.2.0",
+    "react-dom": "^19.2.0"
+  },
+  "devDependencies": {
+    "@tailwindcss/postcss": "^4.3.0",
+    "@types/node": "^22.10.0",
+    "@types/react": "^19.2.0",
+    "@types/react-dom": "^19.2.0",
+    "postcss": "^8.5.15",
+    "tailwindcss": "^4.3.0",
+    "typescript": "^5.7.2"
+  }
+}

apps/web/postcss.config.mjs

@@ -0,0 +1,8 @@
+/** Tailwind CSS v4 PostCSS setup. */
+const config = {
+  plugins: {
+    "@tailwindcss/postcss": {},
+  },
+};
+
+export default config;

apps/web/src/app/globals.css

@@ -0,0 +1,3 @@
+@import "tailwindcss";
+
+/* PYRE global styles. TODO: theme tokens (ember palette) once UI work begins. */

apps/web/src/app/layout.tsx

@@ -0,0 +1,17 @@
+import type { ReactNode } from "react";
+import "./globals.css";
+
+export const metadata = {
+  title: "PYRE — Burn the dead. Feed the PYRE. Claim the Spawn.",
+  description:
+    "Solana wallet cleanup: scan token accounts, close empty ATAs, and recover rent to your wallet.",
+};
+
+// Root layout (Next.js App Router). Intentionally minimal — UI is built in later phases.
+export default function RootLayout({ children }: { children: ReactNode }) {
+  return (
+    <html lang="en">
+      <body>{children}</body>
+    </html>
+  );
+}

apps/web/src/app/page.tsx

@@ -0,0 +1,20 @@
+// PYRE landing page — SKELETON ONLY.
+//
+// TODO (§13): build out the real landing experience and wire up the app:
+//   - Wallet connect (Solana Wallet Adapter) — NO wallet logic here yet.
+//   - Entry point into the scanner UI (POST /api/scan).
+//   - Links to cleanup preview, receipt, Prometheus preview, and admin review.
+//
+// Trust rules: PYRE never holds private keys; signing is always client-side and
+// must be preceded by a decoded-transaction preview that matches what the user
+// sees. See ../../README.md and the repo CLAUDE.md.
+
+export default function HomePage() {
+  return (
+    <main>
+      <h1>PYRE</h1>
+      <p>Burn the dead. Feed the PYRE. Claim the Spawn.</p>
+      {/* TODO: wallet connect button + scanner entry point */}
+    </main>
+  );
+}

apps/web/src/globals.d.ts

@@ -0,0 +1,3 @@
+// Ambient declaration so `tsc --noEmit` accepts global CSS imports
+// (Next.js handles the actual bundling at build time).
+declare module "*.css";

apps/web/tsconfig.json

@@ -0,0 +1,15 @@
+{
+  "extends": "../../tsconfig.base.json",
+  "compilerOptions": {
+    "lib": ["DOM", "DOM.Iterable", "ES2022"],
+    "module": "ESNext",
+    "moduleResolution": "Bundler",
+    "jsx": "preserve",
+    "noEmit": true,
+    "allowJs": true,
+    "incremental": true,
+    "plugins": [{ "name": "next" }]
+  },
+  "include": ["src", "next-env.d.ts", ".next/types/**/*.ts"],
+  "exclude": ["node_modules", "dist", ".next"]
+}