LyricFlip is an interactive on-chain card game where players test their music knowledge by guessing song titles or artists from partial lyrics. Featuring categories by genre and decade, players can wager tokens and compete for bragging rights. Powered by Starknet, LyricFlip blends entertainment, blockchain, and nostalgia in a fun, rewarding way!
- Framework: NestJS
- Language: TypeScript
- Database: MongoDB
- Blockchain: Starknet (Cairo)
- Authentication: JWT
- Real-time Communication: WebSockets
- Node.js (v18+)
- MongoDB (v6+)
- Starknet development environment for local testing
# Clone the repository
git clone https://github.com/your-username/lyricflip-backend.git
# Navigate to the project directory
cd lyricflip-backend
# Install dependencies
npm install# Development mode
npm run start:dev
# Production mode
npm run build
npm run start:prodOnce the application is running, you can access the Swagger API documentation at:
http://localhost:3000/api/docs
This project follows a GitHub-issue based workflow. Check the issues page for current tasks and their status.
- Find an open issue
- Create a feature branch based on the issue number:
feature/issue-123 - Implement the feature or fix
- Create a pull request
# Unit tests
npm run test
# E2E tests
npm run test:e2e
# Test coverage
npm run test:covThe application can be deployed using various methods:
# Build the application
npm run build
# Start the production server
npm run start:prod