About this project

Ludo-Base is a decentralized Ludo gaming experience built on Base, packaged as a Next.js 16 application designed to be Farcaster-ready. It combines a glassmorphism dashboard interface with onchain wallet connectivity and a multiplayer room flow. What it does - Game lobby: a setup flow with pill-style section headers, horizontal game mode selection, match types (1v1, 2v2, 4P), an entry-fee wager area with a large numeric input, stepper controls and quick-select chips, plus QUICK MATCH and WITH FRIENDS call-to-action buttons. - Gameplay: app/components/Board.tsx implements the core Ludo board, and app/components/SnakesBoard.tsx provides a snakes-and-ladders variant. - Multiplayer: PeerJS together with hooks/TeamUpContext.tsx handles room host/join state for playing with friends. - Persistence: lib/matchRecorder.ts contains match result persistence helpers, backed by Supabase. - Wallet and onchain: Wagmi plus Coinbase OnchainKit provide the wallet integration for the Base network. Tech stack Next.js 16 (App Router), React 19, TypeScript 5, Tailwind CSS 4, Framer Motion, Wagmi + Coinbase OnchainKit, Supabase and PeerJS. UI direction The documented visual direction is a dark terminal-glass surface with cyan accents (#00E5FF) for focus and active states, charcoal/graphite gradient backgrounds (#0B0F14 to #141A22) with subtle texture noise, and monospaced support text. The README also records conventions for absolute repo-relative file paths, PascalCase React component filenames and short, action-first interface copy kept consistent between mobile and desktop. Running locally Node.js 20+ and npm are required. Install dependencies with npm install, then start the dev server with npm run dev; the app runs at http://localhost:3000. A production build uses npm run build followed by npm start, and linting is available through npm run lint. An .env.local file must be created with values for the chosen deployment context, covering wallet/network, Supabase and Farcaster/Neynar integrations. Status and caveats The README states its current state as of March 2026, with recent changelog entries focused on lobby layout and padding parity, wager control styling, match-type states and theme/footer adjustments. Some panels still use placeholder or mock data while backend wiring is expanded, and the TeamUp and match persistence flows still need continued hardening for reconnection and edge cases. A game design document and a visual asset guide are included in the repository.