koala73 / worldmonitor

Get started

Taken from the repository's own files on 23 Oct 2026. RepoPilot has not run these commands.

Prerequisites

The files RepoPilot read do not name a runtime version or package manager.

Commands

Makefile

Task	Run	What it runs
lint	`make lint`	`cd $(PROTO_DIR) && buf lint`
check	`make check`	`runs lint generate`
install	`make install`	`runs install-buf install-plugins install-npm install-playwright deps`

Install and use

README.md

git clone https://github.com/koala73/worldmonitor.git
cd worldmonitor
npm install
npm run dev

Open localhost:3000 (override the port with DEV_PORT in .env.local). The app runs with no environment variables.

Feature-specific data sources may require credentials. See .env.example for the full list.

For variant-specific development:

npm run dev:tech       # tech.worldmonitor.app
npm run dev:finance    # finance.worldmonitor.app
npm run dev:commodity  # commodity.worldmonitor.app
npm run dev:happy      # happy.worldmonitor.app
npm run dev:energy     # energy.worldmonitor.app

See the self-hosting guide for deployment options (Vercel, Docker, static).

Open README.md

Developing

CONTRIBUTING.md

Fork the repository on GitHub

Clone your fork locally:

git clone https://github.com/<your-username>/worldmonitor.git
cd worldmonitor

Configure the remotes in this new clone:
```
git remote rename origin fork
git remote add origin https://github.com/koala73/worldmonitor.git
git config remote.pushDefault fork
git fetch origin main
```
Preflight and PR snapshots use origin to identify the repository hosting the PR and its canonical main. Keep your contribution remote named fork and make it the default push target.
Create a branch for your work from current canonical main:
```
git switch -c feature/your-feature-name origin/main
```

Open CONTRIBUTING.md