Rekap

Rekap makes your wallet come alive — it’s like your on-chain activity having a conversation with you. Witty insights, dynamic visuals, and shareable moments turn your crypto journey into something fun and memorable.

Monorepo Structure

• app/ — Next.js 14 (App Router) UI, wallet flow, API routes
• server/ — Bun server for aggregation/analytics + Docker artifacts

Quick Start

Prerequisites: Node 18+, Bun (for server/), pnpm or npm, and a Solana wallet for testing.

Run the Next.js app

cd app
bun install # or npm install
bun run dev     # or npm run dev

App: http://localhost:3000

Run the Bun server (optional)

cd server
bun install
bun run index.ts

Server: http://localhost:8787 (see code for exact port if changed)

Environment Variables

Create .env.local in app/ as needed. Common variables:

• NEXT_PUBLIC_ZERION_API_KEY that enables richer wallet data
• Any additional keys your custom roast backend requires (see app/src/app/api/roast/route.ts)

For the Bun server, create .env in server/ if you need API keys or secrets there.

Scripts

In app/:

• dev — run Next.js in development
• build — build production bundle
• start — start production server

In server/:

• bun run index.ts — start the Bun server
• Dockerfiles and docker-compose.yml are provided for containerized runs

Deployment

• app/ → any Next.js host (Vercel recommended). Ensure env vars are set and /api/* routes are enabled.
• server/ → Dockerized. Use the provided Dockerfile and docker-compose.yml. See server/DEPLOYMENT.md for tips.

Architecture Snapshot

• Frontend: Next.js App Router, edge‑friendly API routes, @solana/wallet-adapter for connect/sign
• Backend: Bun server for aggregation and analytics helpers
• UX: Confetti poppers from top edges on completion, favicon.ico wired via metadata

Troubleshooting

• Redirected back to /? Sign the message on the landing page first (signature gate).
• Empty roasts? Check API keys and response shape used in app/src/app/your-2025-solana-roast/[wallet]/page.tsx.

License

MIT — see LICENSE if present.