Occupied City

This is the codebase for Occupied City. It runs on Vue 3 (see src/js/App.vue).

The site lives at OccupiedCity.webful.uk and is released as open source under the MIT Licence.

Try it out (local dev server)

npm i
npm run dev

This starts a local dev server (no Apache needed).

If you want it to open your browser automatically:

npm run dev:open

If it doesn’t open automatically (or you used dev), visit:

• http://localhost:8080/

Build

npm run build:dev

Webpack output is written to ./web.

Issues

Issues are tracked on GitHub.

Mapping

We currently use Leaflet for maps.

City outlines

We're using Flickr Shapefiles locality data to produce approximate outlines for each included city.

Country outlines

As Flickr shapes were even more noticeably off for at least some countries, we use these approximations instead.

Dependencies

Client libraries managed with npm.

Live builds

There is no CI for now. To build live after uploading src files:

npm i
npm run build

Webpack'd output is placed in and served from ./web.

Requirements

• Node 20+ for build/dev

Tests

Tests were removed in 2022.

Apache virtual host configuration

Apache is no longer required for local development. If you deploy to Apache and want HTML5-history routing, you’ll still need the equivalent rewrite rules.