Installing and building locally

To install and build skraafoto_frontend locally, run these commands:

git clone https://github.com/SDFIdk/skraafoto_frontend
cd skraafoto_frontend
npm install

Configuration (config.js)

Skraafoto expects to find a config.js file in the public folder when hosted.

The contents of config.js should be a single Javascript object defined like so:

const environment = {
  
  // STAC TOKEN can be aquired from https://dataforsyningen.dk/
  API_STAC_TOKEN: "[ INSERT TOKEN ]",

  // DHM URL and auth can be aquired from https://datafordeler.dk/dataoversigt/danmarks-hoejdemodel-dhm/koter/
  API_DHM_TOKENA: "[ INSERT USERNAME-LIKE TOKEN ]",
  API_DHM_TOKENB: "[ INSERT PASSWORD-LIKE TOKEN ]"

}

You'll need to supply your own tokens for your particular configuration. You can copy and edit public/config.js.example to use as your own config.js. Check /src/modules/configuration.js for more configuration options.

Build the documentation

First, run npm run docs to build the documentation pages. Then you can run npm run serve-docs and access the documentation in a browser at http://localhost:8001/

Build for development

Run npm run dev to start a development server running locally at http://localhost:5173/

Build for production

Run npm run build to make a production build. The built resources are saved in dist/ folder; ready to be hosted along with the static assets in the public folder.

Run tests

Playwright E2E tests

You'll need to install Playwright dependencies once before running the E2E tests. Do so with npx playwright install --with-deps

Then make sure you have a local development server running. Run npm run dev, open a browser, and point it to http://localhost:5173/

Now you can run the test using: npm run test or npm run test -- --ui (the latter opens the Playwright test UI)

The Playwright test suite will present you with a HTML report if some tests fail.

Unit tests

Unit tests are run with npm run test-unit

Tutorial: installing

installing