CSCfi / metadata-submitter-frontend

Frontend for Metadata Submission Interface.
https://metadata-submitter.rtfd.io
MIT License
5 stars 2 forks source link
metadata-management react

Submission interface frontend

Unit tests and coverage Code style check Static type checks End-to-end tests Coverage Status

Frontend for CSCs Sensitive Data Archive metadata submitter. See backend for more info

Install and run

Requirements:

Install backend from backend repository.

Install and run frontend either with:

After installing and running, frontend can be found from http://localhost:3000.

Tests

Unit tests

Run Vitest- and React Testing Library-based tests with pnpm test. Check code formatting, TypeScript types and style errors with pnpm run lint:check and fix them with pnpm run lint. Respectively for formatting errors in json/yaml/css/md -files, use pnpm run format:check or pnpm run format.

End-to-end tests

  1. Copy env variables from .env.example to your .env file, these variables are needed to run some of the tests.
  cp .env.example .env
  1. Make sure we have latest browser binaries and their dependencies which match the current playwright version
pnpm dlx playwright install --with-deps

OR if you have issue with your PATH

pnpm exec playwright install --with-deps
  1. Run the tests in CLI:
  pnpm test:e2e

OR you can run the tests in UI mode:

  pnpm test:e2e:ui

Note

e2e tests running in UI mode could have different result from the CLI. So if you are running the tests in UI mode, it may worth checking how they run in CLI as well, since the tests in Gitlab will be running in CLI.

We're following recommended settings from eslint, react and prettier -packages with couple exceptions, which you can find in .eslintrc and .prettierrc. Linting, formatting and testing are also configured for you as a git pre-commit, which is recommended to use to avoid fails on CI pipeline.

Building

Running pnpm run build builds the app for production to the build folder.

Architecture

See architecture.

License

Metadata submission interface is released under MIT, see LICENSE.

Contributing

If you want to contribute to a project and make it better, your help is very welcome. For more info about how to contribute, see CONTRIBUTING.