GeoMaster

GeoMaster is a polished, offline-first geography quiz app built with:

• Next.js 14+ (App Router) + TypeScript
• Tailwind CSS + shadcn/ui-style components
• Framer Motion
• Zustand
• Prisma + SQLite

Local setup

1. Install dependencies

npm install

2. Create an env file

cp .env.example .env

3. Generate Prisma client + create SQLite schema + seed

npm run db:seed

4. Start dev server

npm run dev

Open http://localhost:3000.

Data / offline behavior

• The app does not call external APIs at runtime.
• A local dataset is stored in data/restcountries.json.
• Seeding imports and normalizes that dataset into SQLite.

Optional: refresh dataset from REST Countries during seed

If you want to refresh data/restcountries.json on your machine during seeding:

GEOMASTER_FETCH=1 npm run seed

If the fetch fails, the seed still works from the committed local dataset.

Sources

See the in-app /sources page.