🌜 Rise of Halfmoon
Strategic moon phase card game - Battle the Half Moon
A card game where you connect moon phases to score points. Match same phases, create lunar cycles, and outsmart your opponent!
This project is a clone coding of the Google Doodle Moon game.
I am a big fan of the Google Doodle Moon game, so I decided to recreate it myself.
Original game:
https://doodles.google/doodle/rise-of-the-half-moon/
🎮 Gameplay Preview
✨ Features
- Campaign: 5 boards, from March to December, against an AI that gets tougher as you go
- Star ratings: win by a bigger margin to earn up to ★★★ on each level, then replay any unlocked level to improve your rating
- Daily Challenge: one new board each day, with the same deck for everyone. Your first finished game counts, and you can share the result
- Records: win rate, high score, longest cycle, cycles stolen, daily streak and per-level bests
- Works on desktop and mobile; your progress is saved in your browser, so no account is needed
🎴 Game Rules
Take turns placing moon phase cards from your hand onto the star map. Tap a card, then tap an empty spot (or drag it there on desktop).
Scoring Methods
1. Phase Pair (1 point)
- Match two identical moon phases
- Example: 🌒 + 🌒
2. Full Moon Pair (2 points)
- Match opposite phases that form a full moon
- Example: 🌒 + 🌖
3. Lunar Cycle (N points)
- Connect 3+ cards in phase order
- Score = number of cards in chain
- Example: 🌑 → 🌒 → 🌓 = 3 points
Special Rules
- Chain Steal: Opponent can steal your chain by adding to it
- Card Bonus: +1 point per card you control at game end
Star Ratings
Stars depend on how much you win by, scaled to the board size:
| Rating | Winning margin |
|---|
| ★ | any win |
| ★★ | a third of the board's spots or more |
| ★★★ | two thirds of the board's spots or more |
For example, on March's 9-spot board you need to win by 3 for ★★ and by 6 for ★★★.
🛠 Tech Stack
- Next.js 16 (App Router)
- React 19 + TypeScript
- Tailwind CSS 4
- Framer Motion
🚀 Running Locally
npm install
npm run dev
Then open http://localhost:3000.
📁 Project Structure
app/ Page, game state and turn logic
components/ Screens (start, intro, tutorial, records) and moon cards
components/game Board, player panels, pause menu and result screen
components/ui Shared buttons, modal, icons and background
constants/ Level layouts and theme colors
utils/ Scoring, AI, sounds, records and daily challenge
Connect the cosmos, one phase at a time 🌙
