Mind Block is a puzzle and coding challenge game that offers adaptive, rewarding gameplay tailored to users' IQ and preferences.
Players solve logic-based tasks across categories like coding, puzzles, blockchain, and logic to:
- 🎮 Earn in-game recognition (xp)
- 🚀 Boost problem-solving skills
- 🏆 Compete socially with friends
Mind Block is a next-gen puzzle adventure blending AI-generated challenges with skill-based progression in an immersive experience.
✨ Features include:
- Quick IQ-level survey to personalize your journey
- Puzzles that evolve with your intelligence level
- Categories: coding, logic, blockchain, and more
- Leaderboards and upcoming real-time puzzle battles
Whether you're a beginner or a pro, Mind Block adapts to you—making every challenge rewarding.
This is a monorepo containing three main components:
- Backend (NestJS) – API & game logic
- Frontend (NextJS) – User interface
- Smart Contracts (Soroban) – Stellar testnet deployment
- Backend (NestJS) → Render
- Frontend (NextJS) → (Coming soon on Vercel)
- Contracts (Rust) → Stellar testnet
Follow these steps to clone and set up the project locally.
git clone https://github.com/MindBlockLabs/mindBlock_app.git
cd mindBlock_app- Install dependencies
Each package has its own dependencies. You can install them separately or at ones: Instructions can be found in the general package.json file (script). It is advisable though to install seperately and focus on the folder your isuue is specific to.
Backend (NestJS) cd backend npm install
Frontend (NextJS) cd frontend npm install
Contracts (Soroban)
Make sure you have Scarb and Stellar CLI installed, then:
cd contracts scarb build
- Environment variables
Create a .env file inside the backend and/or frontend folders. For backend:
REDIS_URL=redis://127.0.0.1:6379
DATABASE_API='https://mindblock-webaapp.onrender.com/api'
For frontend:
NEXT_PUBLIC_API_URL=http://localhost:5000
- Run the project Backend cd backend npm run start:dev
Frontend cd frontend npm run dev
Contracts
Deploy your Soroban contracts on Stellar testnet:
cd contracts stellar-compile stellar-deploy
📢 General Telegram Group: Join here
📧 Owner Emails:
We ❤️ contributions!
Fork the repo
Create a new branch:
git checkout -b feature/your-feature-name
Commit changes with clear messages:
git commit -m "feat: add puzzle leaderboard"
Push and open a Pull Request (PR).
💡 For issues/bugs, please open an issue.
📜 License
This project is licensed under the MIT License.