Documentation Index
Fetch the complete documentation index at: https://mintlify.com/igorek05m/daily-geogame/llms.txt
Use this file to discover all available pages before exploring further.
Prerequisites
Before installing Daily GeoGame, ensure you have the following installed on your system:- Node.js 20.x or higher
- pnpm (recommended package manager)
While you can use npm or yarn, this project uses pnpm for dependency management. We recommend using pnpm for the best experience.
Clone the repository
First, clone the Daily GeoGame repository from GitHub:Install dependencies
Install the project dependencies using your preferred package manager:Key dependencies
Daily GeoGame includes the following core dependencies:- next (15.5.9) - React framework with App Router
- react (19.1.0) - UI library
- mongodb (^6.19.0) - Database driver for MongoDB Atlas
- typescript (^5) - Type safety
- tailwindcss (^4) - Styling
- framer-motion (^12.34.1) - Animations
- d3-geo (^3.1.1) - Geographic projections
- react-zoom-pan-pinch (^3.7.0) - Interactive map controls
Running the development server
Before running the development server, you’ll need to configure your environment variables. See the Configuration guide for details. Once configured, start the development server:http://localhost:3000.
The dev script uses Turbopack (
next dev --turbopack) for faster development builds.Verify installation
To verify that everything is installed correctly:Check the dev server
Ensure the development server starts without errors and you can access
http://localhost:3000.Check database connection
The application should connect to MongoDB. Check the console for any MongoDB connection warnings.
Common installation issues
Port already in use
If port 3000 is already in use, Next.js will automatically try the next available port (3001, 3002, etc.).MongoDB connection errors
If you seeWARN: Missing MONGODB_URI environment variable, you need to configure your .env.local file. See the Configuration guide.
Node version mismatch
Daily GeoGame requires Node.js 20.x or higher. Check your version:pnpm not installed
Install pnpm globally:Available scripts
The following npm scripts are available:| Script | Command | Description |
|---|---|---|
dev | next dev --turbopack | Start development server with Turbopack |
build | next build --turbopack | Create production build |
start | next start | Start production server |
lint | eslint | Run ESLint for code quality |
Next steps
After installation, proceed to:- Configuration - Set up environment variables and MongoDB
- Deployment - Deploy to Vercel or other platforms