"Will you remember?"
Alithea is a memory training game built on the Sui blockchain. Train your memory, prove your skill, and earn rewards. Named after the Greek concept of Aletheia (truth/unveiling) โ because memory is about revealing what's hidden.
- URL: https://alitia.vercel.app (Sui testnet)
- Smart contracts: deployed on Sui testnet โ package
0x87326959ace8e0f0703054b5919c972f0309781e380b6d9784cb98f7779a0b6d
- Spin the Cup โ the beginner game. Three cups, one pebble. Follow the shuffle.
- Classic Pairs โ flip, remember, match (4x4 and 6x6 grids)
- Pattern Echo โ Simon-says sequence memory
- Number Vault โ digit recall (forward, reverse, ascending)
- Chasing Stars โ spatial memory grid
- Color Cascade โ color sequence memory
- Word Chain โ verbal memory
- Pathfinder โ route memory
- Rhythm Recall โ auditory memory
- Spaceship Run โ remember the safe route through the asteroids and reach the planet
Every game ships with a built-in guide: how to play, beginner tips, and pro tips. Open
the "How to Play" button on any game screen, or browse the Beginner Guides section on
the landing page. Guides are versioned (updated field) and refreshed as the arena evolves.
- No emojis anywhere โ lucide.dev icons only.
- Apple-inspired dark design system (see
frontend/src/app/globals.css).
- Node.js 18+
- Sui CLI (Install Guide)
- Sui Wallet (Chrome Extension)
# Clone the repo
git clone https://github.com/xi-kki/alithea.git
cd alithea/frontend
# Install dependencies
npm install
# Start development server
npm run devOpen http://localhost:3000 in your browser.
# Navigate to contracts
cd contracts
# Build the contract
sui move build
# Run tests
sui move test
# Deploy to testnet
sui client publish --gas-budget 100000000alithea/
โโโ contracts/ # Sui Move smart contracts
โ โโโ sources/
โ โ โโโ game.move # Core game logic
โ โโโ tests/
โ โโโ Move.toml
โโโ frontend/ # Next.js + Sui SDK
โ โโโ src/
โ โ โโโ app/ # Pages & routing
โ โ โโโ components/ # React components
โ โ โโโ lib/ # Utilities
โ โโโ package.json
โโโ scripts/ # Deploy scripts
โโโ README.md
- Connect Wallet โ Click "Connect Wallet" in the top right
- Choose Mode โ Select 4ร4 (Beginner) or 6ร6 (Challenge)
- Find Pairs โ Click cards to reveal them, remember their positions
- Match Cards โ Find all matching pairs to complete the game
- Earn Score โ Your score is based on:
- Moves: Fewer moves = higher score
- Speed: Complete under 30 seconds for bonus
- Combos: Consecutive matches multiply your score
BASE SCORE: 1,000
MOVES PENALTY:
- Extra moves beyond minimum: -10 points each
SPEED BONUS:
- Complete in < 30 seconds: +500 points
COMBO BONUS:
- 2 consecutive matches: +100 points
- 3+ consecutive matches: +200 points
| Layer | Technology |
|---|---|
| Blockchain | Sui (Testnet) |
| Smart Contracts | Move Language |
| Frontend | Next.js 14 + TypeScript |
| Styling | Tailwind CSS |
| Wallet | @mysten/dapp-kit |
| SDK | @mysten/sui |
Classic Pairs features 18 unique card faces rendered with lucide.dev icons.
- Phase 1: Foundation (Project setup)
- Phase 2: Core Move Contract (Game logic)
- Phase 3: Frontend (Game UI)
- Phase 4: Additional Game Modes (10/10 complete)
- Phase 5: Beginner guides for every game
- Phase 6: Deployment (live at https://alitia.vercel.app)
- Phase 7: Smart contracts deployed to Sui testnet
- Phase 8: Token & Achievements (Future)
- Phase 9: Tournaments (Future)
- Phase 10: Mobile Optimization (Future)
Contributions are welcome! Please feel free to submit a Pull Request.
- Fork the repository
- Create your feature branch (
git checkout -b feature/amazing-feature) - Commit your changes (
git commit -m 'Add amazing feature') - Push to the branch (
git push origin feature/amazing-feature) - Open a Pull Request
This project is licensed under the MIT License โ see the LICENSE file for details.
Live at https://alitia.vercel.app (project xi-kkis-projects/alitia, root directory frontend).
Environment variables (production):
NEXT_PUBLIC_SUI_NETWORK=testnetNEXT_PUBLIC_SUI_RPC_URL=https://fullnode.testnet.sui.io:443NEXT_PUBLIC_CONTRACT_PACKAGE_ID=0x87326959ace8e0f0703054b5919c972f0309781e380b6d9784cb98f7779a0b6dNEXT_PUBLIC_CONTRACT_MODULE=alithea
Published 2026-08-10 โ package 0x87326959ace8e0f0703054b5919c972f0309781e380b6d9784cb98f7779a0b6d
(see contracts/Published.toml). Build with sui move build, publish with
sui client publish --gas-budget 500000000.
Built with โค๏ธ on Sui
๐ง Alithea โ Will you remember? ๐ง