Revamp: monorepo with contracts and frontend

[nkrishang]

Monorepo Restructure with Contracts, Indexer, and Leaderboard

Summary

This PR restructures the 2048 frontend into a monorepo containing three packages: contracts, frontend, and indexer. It introduces a real-time leaderboard feature powered by an Envio indexer that tracks game scores, move counts, and gas usage from on-chain events.

Changes

Monorepo Architecture

Converted the single-package frontend into a pnpm workspace monorepo with:

• packages/contracts - Foundry-based Solidity smart contracts for the 2048 game logic
• packages/frontend - React/Vite frontend application
• packages/indexer - Envio-based blockchain indexer for game event tracking

Smart Contracts (packages/contracts)

Added the complete 2048 game smart contracts:

• Monad2048.sol - Main game contract managing state, move validation, and replay prevention
• LibBoard.sol - Pure library implementing 2048 game mechanics (tile compression, merging, move processing)
• Comprehensive test suite with LibBoardTest.t.sol and Monad2048Test.t.sol
• Deployment scripts and broadcast logs for Monad mainnet

Indexer (packages/indexer)

Built an Envio indexer that processes NewGame and NewMove events to maintain:

• Game entity - Tracks score, highest tile, move count, board state, and gas metrics per game
• Player entity - Aggregates total games played, moves, MON burned, and best score per address
• GameMove entity - Records each move with board states, score delta, and gas costs
• IndexerStatus entity - Exposes sync progress for frontend state management

The indexer calculates scores by detecting merged tiles from board state diffs, matching the frontend's scoring logic.

Frontend Updates

Leaderboard Feature:

• Leaderboard.tsx - Animated top 10 high scores display with rank indicators, player stats (moves, gas, MON burned), and current player highlighting
• useLeaderboard.ts - Hook with 5-second polling, visibility-aware updates, and "new entry" detection
• useIndexerStatus.ts - Hook for indexer sync status
• State-aware UI with loading, syncing, empty, and error states

Bug Fixes:

• Fixed score calculation sync between local state and indexer
• Clear board state on logout to prevent stale game data
• Fixed toast explorer link URLs
• Updated UI layout for leaderboard integration

Configuration:

• Removed testnet toggle, defaulting to mainnet only
• Simplified network context

CI/CD

Added ci.yml with parallel jobs for:

• Frontend - Lint and build
• Contracts - Forge format check, build, and test
• Indexer - Envio codegen and test

Documentation

• ARCHITECTURE.md - Technical overview of contract design, board encoding, and transaction flow
• FEATURE.md - Leaderboard feature specification and implementation details
• MIGRATION.md - Migration guide for the monorepo restructure

[vercel]

Deployment failed with the following error:

You don't have permission to create a Preview Deployment for this Vercel project: 2048-frontend.

View Documentation: https://vercel.com/docs/accounts/team-members-and-roles

[socket-security]

Review the following changes in direct dependencies. Learn more about Socket for GitHub.

Diff	Package	Supply Chain Security	Vulnerability	Quality	Maintenance	License
	@​rescript/​react@​0.12.1
	rescript-envsafe@​5.0.0
	typescript-eslint@​8.50.1 ⏵ 8.53.1
	ink-big-text@​1.2.0
	ink-spinner@​4.0.3
	@​types/​mocha@​10.0.10
	@​types/​react@​19.2.7 ⏵ 19.2.9	+1		+1
	postgres@​3.4.1
	date-fns@​3.3.1
	@​types/​node@​22.19.3 ⏵ 20.19.30
	@​types/​node@​22.19.3 ⏵ 22.19.7	+1		+1
	js-sdsl@​4.4.2
	ts-node@​10.9.1
	envio@​2.32.3
	react@​18.2.0
	yargs@​17.7.2
	ethers@​6.8.0
	dotenv@​16.4.5
	graphql@​16.12.0
	ink@​3.2.0
	graphql-request@​7.4.0
	express@​4.19.2
	mocha@​10.8.2
	framer-motion@​11.18.2

View full report

[vercel]

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

Project	Deployment	Review	Updated (UTC)
2048-frontend	Ready	Preview, Comment	Jan 29, 2026 1:21pm