Skip to content
xi-kkiPublic

About

๐Ÿง  Alithea โ€” Memory Training Arena on Sui blockchain. Train your memory with Classic Pairs, Pattern Echo, and Number Vault. Play-to-earn rewards coming soon. Built with Move + Next.js + Apple design.

Topics

Resources

Stars

0 stars

Watchers

0 watching

Forks

Latest commit

ย 

History

11 Commits

Folders and files

NameName
Last commit message
Last commit date
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 

Repository files navigation

๐Ÿง  Alithea โ€” Memory Training Arena

"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.

Alithea Sui Move Next.js

๐ŸŽฎ Features

Play Live

  • URL: https://alitia.vercel.app (Sui testnet)
  • Smart contracts: deployed on Sui testnet โ€” package 0x87326959ace8e0f0703054b5919c972f0309781e380b6d9784cb98f7779a0b6d

The 10 Game Modes

  • 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

Beginner Guides

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.

Design rules

  • No emojis anywhere โ€” lucide.dev icons only.
  • Apple-inspired dark design system (see frontend/src/app/globals.css).

๐Ÿš€ Quick Start

Prerequisites

  • Node.js 18+
  • Sui CLI (Install Guide)
  • Sui Wallet (Chrome Extension)

Frontend Setup

# Clone the repo
git clone https://github.com/xi-kki/alithea.git
cd alithea/frontend

# Install dependencies
npm install

# Start development server
npm run dev

Open http://localhost:3000 in your browser.

Contract Setup

# Navigate to contracts
cd contracts

# Build the contract
sui move build

# Run tests
sui move test

# Deploy to testnet
sui client publish --gas-budget 100000000

๐Ÿ—๏ธ Architecture

alithea/
โ”œโ”€โ”€ 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

๐ŸŽฏ How to Play

  1. Connect Wallet โ€” Click "Connect Wallet" in the top right
  2. Choose Mode โ€” Select 4ร—4 (Beginner) or 6ร—6 (Challenge)
  3. Find Pairs โ€” Click cards to reveal them, remember their positions
  4. Match Cards โ€” Find all matching pairs to complete the game
  5. 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

๐Ÿ“Š Scoring System

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

๐Ÿ› ๏ธ Tech Stack

Layer Technology
Blockchain Sui (Testnet)
Smart Contracts Move Language
Frontend Next.js 14 + TypeScript
Styling Tailwind CSS
Wallet @mysten/dapp-kit
SDK @mysten/sui

๐ŸŽจ Card Themes

Classic Pairs features 18 unique card faces rendered with lucide.dev icons.

๐Ÿ“ˆ Progress

  • 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)

๐Ÿค Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

  1. Fork the repository
  2. Create your feature branch (git checkout -b feature/amazing-feature)
  3. Commit your changes (git commit -m 'Add amazing feature')
  4. Push to the branch (git push origin feature/amazing-feature)
  5. Open a Pull Request

๐Ÿ“ License

This project is licensed under the MIT License โ€” see the LICENSE file for details.

๐Ÿš€ Deployment

Vercel (Frontend)

Live at https://alitia.vercel.app (project xi-kkis-projects/alitia, root directory frontend).

Environment variables (production):

  • NEXT_PUBLIC_SUI_NETWORK=testnet
  • NEXT_PUBLIC_SUI_RPC_URL=https://fullnode.testnet.sui.io:443
  • NEXT_PUBLIC_CONTRACT_PACKAGE_ID=0x87326959ace8e0f0703054b5919c972f0309781e380b6d9784cb98f7779a0b6d
  • NEXT_PUBLIC_CONTRACT_MODULE=alithea

Sui Testnet (Contracts)

Published 2026-08-10 โ€” package 0x87326959ace8e0f0703054b5919c972f0309781e380b6d9784cb98f7779a0b6d (see contracts/Published.toml). Build with sui move build, publish with sui client publish --gas-budget 500000000.

๐Ÿ”— Links

๐Ÿ’ฌ Contact

Built with โค๏ธ on Sui


๐Ÿง  Alithea โ€” Will you remember? ๐Ÿง 

About

๐Ÿง  Alithea โ€” Memory Training Arena on Sui blockchain. Train your memory with Classic Pairs, Pattern Echo, and Number Vault. Play-to-earn rewards coming soon. Built with Move + Next.js + Apple design.

Topics

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages