Frontend
React + TypeScript + Vite
Component-driven UI with React 18, TypeScript for type safety, and Vite for instant dev server and HMR. Built with glassmorphism aesthetics and responsive design patterns.

Initialize your Harvest-Hallow development environment
Welcome to the Harvest-Hallow developer setup guide. This walkthrough covers the complete initialization workflow for getting the full-stack game up and running. Designed for developers maintaining the monorepo, this guide steps through scaffolding the project, configuring the game engine with worker placement rules, wiring up the backend API endpoints for player actions and lobby management, and integrating the MariaDB database for persistent game state. Each step includes concrete commands, configuration snippets, and verification checkpoints to ensure a smooth setup experience.
The Harvest-Hallow development path begins with a clean monorepo initialization, proceeds through core engine and API setup, and culminates in a fully operational multiplayer worker-placement game. Follow the numbered steps below, and refer to each section for detailed configuration guidance.
Follow these six steps to get the full Harvest-Hallow stack running on your machine — from monorepo clone to passing tests.
Start by cloning the Harvest-Hallow monorepo from the central repository. This gives you the full project tree including the game engine, backend API, frontend client, and shared types.
git clone https://github.com/harvest-hallow/monorepo.git cd monorepo
Harvest-Hallow uses a pnpm workspace to manage dependencies across its packages. A single install command wires up the game engine, API server, and React frontend in one pass.
pnpm install
Each service expects its own .env file. Copy the provided example templates and fill in the values relevant to your environment — database credentials, API keys, and game server settings.
cp apps/api/.env.example apps/api/.env cp apps/web/.env.example apps/web/.env cp apps/engine/.env.example apps/engine/.env
Harvest-Hallow uses Prisma ORM to define the game-state schema — players, workers, resources, buildings, event cards, and round history. Run the migration to create all tables.
pnpm --filter @harvest-hallow/api prisma migrate dev --name init pnpm --filter @harvest-hallow/api prisma db seed
Launch the monorepo in development mode. Turborepo orchestrates the API, game engine, and Vite-powered frontend with hot-reload across all packages.
pnpm dev
Confirm everything is wired correctly by running the full test suite. Harvest-Hallow maintains comprehensive coverage across unit tests (game logic), integration tests (API endpoints), and E2E tests (Playwright).
pnpm test pnpm test:e2e
A modern full-stack monorepo built for real-time multiplayer board gaming. Every layer is optimized for developer velocity and production reliability.
React + TypeScript + Vite
Component-driven UI with React 18, TypeScript for type safety, and Vite for instant dev server and HMR. Built with glassmorphism aesthetics and responsive design patterns.
Node + TypeScript + Fastify
High-performance REST and WebSocket API server using Fastify. TypeScript ensures strict validation of game state, player actions, and multiplayer message protocols.
Prisma + SQLite / Postgres
ORM-driven data layer with Prisma for type-safe queries and migrations. SQLite for local development, PostgreSQL for production — seamless swap via a single config flag.
Socket.IO
Bidirectional event channels for multiplayer lobbies, worker placement broadcasts, round resolution, and live game-state sync across all connected players.
Set up your Harvest-Hallow development environment in minutes. Clone the monorepo, install dependencies, and launch the full stack with a single command. Follow along below to go from zero to a running game server.

Lead your woodland clan through six rounds of strategic worker placement. Gather resources, construct buildings, and earn the most victory points to thrive through winter.
Every decision matters. Balance your collection of Food, Wood, Stone, Herbs, and Coins to build the most prosperous village in the hollow.
Sustain your workers through harsh winters. Essential for feeding your growing clan each round.
The backbone of construction. Chop timber from Timber Trail to build shelters and workshops.
Quarry durable stone for fortifications and the most prestigious village structures.
Gather rare herbs from Forage Grove for potent concoctions and healing remedies.
Trade at the village market. Coins unlock special actions and powerful one-time bonuses.
Each round follows a simple rhythm. Master the flow and outmaneuver your opponents across six rounds of strategic depth.
Assign your three workers to board spaces like Forage Grove, Timber Trail, or the Stone Quarry.
Collect Food, Wood, Stone, Herbs, and Coins based on where your workers are placed.
Spend resources to construct buildings that grant victory points and special village abilities.
Tally victory points, draw an event card, and prepare for the next of six rounds.
Whether gathered around one screen or competing online, Harvest Hallow adapts to your play style.
Gather around one device and take turns placing workers. Perfect for cozy game nights with friends and family.
Challenge players worldwide in real-time matches. Create a lobby, invite friends, and compete for the highest score.
Pause your game and pick up right where you left off. Complete game states are preserved between sessions.
Gather your workers, plan your strategy, and prepare for winter. The village awaits your leadership.
No comments yet. Be the first!