Census Atlas

A prototype for exploring neighbourhood level Census data tables on a map, powered by Svelte Kit.

Latest version available at: https://ons-data-map.netlify.app

Architecture

See ARCHITECTURE.

Development

Clone the repository and install all dependencies with npm install, then start a development server:

npm run dev

# or start the server with https
npm run dev -- --https

# or start the server and open the app in a new browser tab
npm run dev -- --open

There's an attempt at a kitchen sink with all the components at: /components but please note it might be incomplete, or not up to date. This will eventually be replaced by something like Storybook.

There's also a page dedicated to ONS Design System components specifically: /design-system

Testing

Unit

To run the full suite of unit tests:

npm test

# or to run an individual test file
npm test -- [fileName].test

Integration

Run Cypress:

npx cypress open

Deploy process

We're using Netlify adapter at the moment which runs via GitHub Actions each time we push code.

There are other adapters to suit our final target environment.

To build locally:

npm run build

To preview the built app:

npm run preview

Bugs

Due to the beta nature of Svelte Kit there might be issues requiring temporary workarounds.

In order to minimise the PITA factor:

• Make sure you're on latest next version: npm upgrade @sveltejs/kit
• If issue persist, check their GitHub Issues page and changelogs for pointers
• Join Svelte's Discord and search for your issue; this usually gives much better results than Google