World Power Stations

World Power Stations (WPS) is an interactive world map of power generation and storage stations.

Stack

• Frontend: React, React Router, TailwindCSS
• Backend: React Router API routes
• Map library: MapLibre GL JS
• Database: PostgreSQL with PostGIS and full-text search via pgvector
• Testing: Jest, React Testing Library
• Infrastructure: deployed to Vercel

Roadmap

Versioning schema:

• Major version: countries with the largest share of primary energy consumption from renewable sources as per the Statistical Review of World Energy (2025).
• Minor version: sequential integer number prefixed with "V".
• Patch version: sequential integer.

Next major releases:

• Iceland V1 (MVP/core features): main UI (world map with station details), energy source filters, SSR/SEO (ranks on Google), manual data input (no admin panel yet, but pulls data from API endpoint). Data = only power generation stations for now (no power storage data/icons).

Getting Started

Installation

Install the dependencies:

npm install

Development

Start the development server with HMR:

npm run dev

Your application will be available at http://localhost:5173.

Building for Production

Create a production build:

npm run build

Deployment

Docker Deployment

To build and run using Docker:

docker build -t my-app .

# Run the container
docker run -p 3000:3000 my-app

The containerized application can be deployed to any platform that supports Docker, including:

• AWS ECS
• Google Cloud Run
• Azure Container Apps
• Digital Ocean App Platform
• Fly.io
• Railway

DIY Deployment

If you're familiar with deploying Node applications, the built-in app server is production-ready.

Make sure to deploy the output of npm run build

├── package.json
├── package-lock.json (or pnpm-lock.yaml, or bun.lockb)
├── build/
│   ├── client/    # Static assets
│   └── server/    # Server-side code

Styling

This template comes with Tailwind CSS already configured for a simple default starting experience. You can use whatever CSS framework you prefer.

---

Built with ❤️ using React Router.