{"id":23421238,"url":"https://github.com/nhsdigital/galleri-frontend","last_synced_at":"2025-04-12T14:06:04.209Z","repository":{"id":180396552,"uuid":"665053595","full_name":"NHSDigital/Galleri-Frontend","owner":"NHSDigital","description":"This repo will hold the code for the front end of the Galleri Pilot System","archived":false,"fork":false,"pushed_at":"2024-05-17T15:42:40.000Z","size":2284,"stargazers_count":5,"open_issues_count":5,"forks_count":0,"subscribers_count":4,"default_branch":"main","last_synced_at":"2024-05-17T17:26:35.391Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"CSS","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/NHSDigital.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":".github/SECURITY.md","support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2023-07-11T10:31:03.000Z","updated_at":"2024-05-20T14:00:59.852Z","dependencies_parsed_at":"2023-10-23T16:29:16.462Z","dependency_job_id":"08341c89-03e1-43fc-bf87-a5d1ee7d94a2","html_url":"https://github.com/NHSDigital/Galleri-Frontend","commit_stats":null,"previous_names":["nhsdigital/galleri-frontend"],"tags_count":7,"template":false,"template_full_name":"NHSDigital/repository-template","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/NHSDigital%2FGalleri-Frontend","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/NHSDigital%2FGalleri-Frontend/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/NHSDigital%2FGalleri-Frontend/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/NHSDigital%2FGalleri-Frontend/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/NHSDigital","download_url":"https://codeload.github.com/NHSDigital/Galleri-Frontend/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248578863,"owners_count":21127713,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2024-12-23T02:14:31.904Z","updated_at":"2025-04-12T14:06:04.008Z","avatar_url":"https://github.com/NHSDigital.png","language":"CSS","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Galleri Frontend\n\nThis repository contains the frontend for the Galleri webapp. It is written in javascript and uses nextjs.\n\n## Table of Contents\n\n- [Galleri Frontend](#galleri-frontend)\n  - [Table of Contents](#table-of-contents)\n  - [Installation](#installation)\n    - [Clone the repository](#clone-the-repository)\n    - [Install dependencies](#install-dependencies)\n    - [Start the webserver in dev mode](#start-the-webserver-in-dev-mode)\n    - [Start the webserver in production mode](#start-the-webserver-in-production-mode)\n    - [NPM Prerequisites](#npm-prerequisites)\n  - [makefile](#makefile)\n    - [Install and configure toolchain dependencies](#install-and-configure-toolchain-dependencies)\n    - [Make Prerequisites](#make-prerequisites)\n  - [Usage](#usage)\n  - [Prettifier](#prettifier)\n  - [Architecture](#architecture)\n    - [Diagrams](#diagrams)\n    - [Configuration](#configuration)\n  - [Contributing](#contributing)\n  - [Contacts](#contacts)\n  - [Licence](#licence)\n\n## Installation\n\nTo get started with this repo follow these steps:\n\n### Clone the repository\n\n```shell\ngit git@github.com:NHSDigital/Galleri-Frontend.git\ncd Galleri-Frontend\n```\n\n### Install dependencies\n\n```shell\nnpm install\n```\n\n### Start the webserver in dev mode\n\n```shell\nnpm run dev\n```\n\n### Start the webserver in production mode\n\nWhen this code is deployed into production it will use a port specified by an environmental variable, but you can run this locally to verify it works correctly:\n\n```shell\nPORT=8080 npm run start\n```\n\n### NPM Prerequisites\n\nnodejs - 16.20.0\n\n## makefile\n\nTo use the makefile follow these instructions:\n\n```shell\ncd Galleri-Frontend\n```\n\n### Install and configure toolchain dependencies\n\n```shell\nmake config\n```\n\n### Make Prerequisites\n\nThe following software packages or their equivalents are expected to be installed\n\n- [GNU make](https://www.gnu.org/software/make/)\n- [Docker](https://www.docker.com/)\n\n## Usage\n\nAfter a successful installation, provide an informative example of how this project can be used. Additional code snippets, screenshots and demos work well in this space. You may also link to the other documentation resources, e.g. the [User Guide](./docs/user-guide.md) to demonstrate more use cases and to show more features.\n\n## Prettifier\n\nFor linting we have decided to use [prettier](https://marketplace.visualstudio.com/items?itemName=esbenp.prettier-vscode) Which we have created config files for called `.prettierrc.yaml` This file enforces consistancy between all users.\n\nTo set this up you need to install the prettier plugin using the link above.\n\nOnce it is installed you can set up the default formatter by opening a file in the repo and using the shortcut `ctrl + p` to open the vscode command interface. Then enter `\u003e Format Document` and select `Format Document` from the dropdown. The first time you do this it will say something like **No default formatter setup for this project** You can click on the `Configure` button and select Prettier from that list.\n\nTo make formatting easier you can enable **Format on Save** by going into preferences and searching for `format on save` then check the tickbox to enable it. Now everytime you save your file with `ctrl + s` or `command + s` then it will format the file for you.\n\n## Architecture\n\n### Diagrams\n\nThe [C4 model](https://c4model.com/) is a simple and intuitive way to create software architecture diagrams that are clear, consistent, scalable and most importantly collaborative. This should result in documenting all the system interfaces, external dependencies and integration points.\n\n![Repository Template](./docs/diagrams/Repository_Template_GitHub_Generic.png)\n\n### Configuration\n\nMost of the projects are built with customisability and extendability in mind. At a minimum, this can be achieved by implementing service level configuration options and settings. The intention of this section is to show how this can be used. If the system processes data, you could mention here for example how the input is prepared for testing - anonymised, synthetic or live data.\n\n## Contributing\n\nDescribe or link templates on how to raise an issue, feature request or make a contribution to the codebase. Reference the other documentation files, like\n\n- Environment setup for contribution, i.e. `CONTRIBUTING.md`\n- Coding standards, branching, linting, practices for development and testing\n- Release process, versioning, changelog\n- Backlog, board, roadmap, ways of working\n- High-level requirements, guiding principles, decision records, etc.\n\n## Contacts\n\nProvide a way to contact the owners of this project. It can be a team, an individual or information on the means of getting in touch via active communication channels, e.g. opening a GitHub discussion, raising an issue, etc.\n\n## Licence\n\n\u003e The [LICENCE.md](./LICENCE.md) file will need to be updated with the correct year and owner\n\nUnless stated otherwise, the codebase is released under the MIT License. This covers both the codebase and any sample code in the documentation.\n\nAny HTML or Markdown documentation is [© Crown Copyright](https://www.nationalarchives.gov.uk/information-management/re-using-public-sector-information/uk-government-licensing-framework/crown-copyright/) and available under the terms of the [Open Government Licence v3.0](https://www.nationalarchives.gov.uk/doc/open-government-licence/version/3/).\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fnhsdigital%2Fgalleri-frontend","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fnhsdigital%2Fgalleri-frontend","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fnhsdigital%2Fgalleri-frontend/lists"}