纯 Vibe coding 项目，演示效果：https://2048.linux.do
A complete 2048 game implementation with client-server architecture, OAuth2 authentication, and leaderboards.
- Victory Condition: Game ends when two 8192 tiles merge
- Mobile Compatible: Responsive design with touch support
- Real-time Communication: WebSocket-based client-server communication
- Authentication: OAuth2 integration for user login
- Leaderboards: Daily, weekly, monthly, and all-time rankings
- Production Ready: Docker deployment with embedded static files
- Runtime: Bun
- Languages: HTML5, CSS3, JavaScript (ES6+)
- Communication: WebSocket
- Build: Bun bundler
- Language: Go 1.21+
- Framework: Gin
- Database: PostgreSQL
- Cache: Redis (optional)
- Authentication: OAuth2
- Communication: WebSocket (gorilla/websocket)
- Containerization: Docker & Docker Compose
- Static Files: Embedded in Go binary
- Database: PostgreSQL container
- Cache: Redis container
- Docker & Docker Compose
- Bun (for development)
- Go 1.21+ (for development)
- Clone and setup:
git clone <repository>
cd game2048
cp .env.example .env
# Edit .env with your OAuth2 credentials- Start development environment:
# Start database
docker-compose up -d postgres redis
# Start backend (development mode)
cd backend
go run cmd/server/main.go
# Start frontend (development mode)
cd frontend
bun install
bun dev# Build and deploy everything
docker-compose up -dThe game will be available at http://localhost:6060
- Frontend sends user inputs (swipe/key directions) via WebSocket
- Server processes game logic and returns updated game state
- Server manages scoring, victory conditions, and game persistence
- Real-time leaderboard updates
- User clicks "Login" → Redirected to OAuth2 provider
- OAuth2 callback → Server validates and creates session
- WebSocket connection established with authenticated session
- Game state tied to user account
- users: User profiles from OAuth2
- games: Game sessions and final scores
- leaderboards: Cached ranking data
- daily_scores, weekly_scores, monthly_scores: Time-based rankings
cd frontend
bun install
bun dev # Development server
bun build # Production buildcd backend
go mod tidy
go run cmd/server/main.go # Development server
go build -o bin/server cmd/server/main.go # Production buildcd backend
go run migrations/migrate.go up # Apply migrations
go run migrations/migrate.go down # Rollback migrationsEnvironment variables (see .env.example):
# Database
DB_HOST=localhost
DB_PORT=5432
DB_NAME=game2048
DB_USER=postgres
DB_PASSWORD=password
# Redis (optional)
REDIS_HOST=localhost
REDIS_PORT=6379
# OAuth2
OAUTH2_CLIENT_ID=your_client_id
OAUTH2_CLIENT_SECRET=your_client_secret
OAUTH2_REDIRECT_URL=http://localhost:6060/auth/callback
OAUTH2_PROVIDER=google # google, github, etc.
# Server
SERVER_PORT=6060
JWT_SECRET=your_jwt_secretClient → Server:
move:{direction: "up|down|left|right"}new_game:{}get_leaderboard:{type: "daily|weekly|monthly|all"}
Server → Client:
game_state:{board: [[]], score: number, gameOver: boolean, victory: boolean}leaderboard:{rankings: [{user: string, score: number, rank: number}]}error:{message: string}
MIT License