{"id":23421117,"url":"https://github.com/nhsdigital/eps-prescription-tracker-ui","last_synced_at":"2026-01-28T18:01:12.448Z","repository":{"id":256171102,"uuid":"854445464","full_name":"NHSDigital/eps-prescription-tracker-ui","owner":"NHSDigital","description":"eps-prescription-tracker-ui","archived":false,"fork":false,"pushed_at":"2026-01-21T17:02:37.000Z","size":91558,"stargazers_count":2,"open_issues_count":10,"forks_count":1,"subscribers_count":1,"default_branch":"main","last_synced_at":"2026-01-21T22:56:34.168Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"other","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/NHSDigital.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":"CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":"SECURITY.md","support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2024-09-09T07:26:30.000Z","updated_at":"2026-01-21T11:12:15.000Z","dependencies_parsed_at":"2024-11-18T19:19:51.794Z","dependency_job_id":"e3a34e6e-2006-4b04-ac21-1daa845a7f03","html_url":"https://github.com/NHSDigital/eps-prescription-tracker-ui","commit_stats":null,"previous_names":["nhsdigital/eps-prescription-tracker-ui"],"tags_count":53,"template":false,"template_full_name":null,"purl":"pkg:github/NHSDigital/eps-prescription-tracker-ui","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/NHSDigital%2Feps-prescription-tracker-ui","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/NHSDigital%2Feps-prescription-tracker-ui/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/NHSDigital%2Feps-prescription-tracker-ui/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/NHSDigital%2Feps-prescription-tracker-ui/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/NHSDigital","download_url":"https://codeload.github.com/NHSDigital/eps-prescription-tracker-ui/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/NHSDigital%2Feps-prescription-tracker-ui/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":28848336,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-01-28T15:15:36.453Z","status":"ssl_error","status_checked_at":"2026-01-28T15:15:13.020Z","response_time":57,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"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:04.860Z","updated_at":"2026-01-28T18:01:12.415Z","avatar_url":"https://github.com/NHSDigital.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Electronic Prescription Service Prescription Tracker UI\n\n![Build](https://github.com/NHSDigital/eps-prescription-tracker-uii/workflows/release/badge.svg?branch=main)\n\nThis is the code for the Prescription Tracker UI.\n\n- `packages/cpt-ui` Client side react front end for Prescription Tracker UI\n- `packages/cdk/` Contains the cdk code used to define the stacks.\n- `packages/cloudfrontFunctions/` Functions used to modify the requests and responses in CloudFront.\n- `packages/staticContent/` Static content used by the website.\n- `packages/cognito/` Lambda function used by cognito\n- `packages/CIS2SignOutLambda/` Lambda function used by CIS2 to sign out users\n- `packages/prescriptionListLambda/` Lambda function used to list prescriptions\n- `packages/patientSearchLambda/` Lambda function used to search for patients\n- `packages/common/middyErrorHandler/` Common error handler used by the lambda functions\n- `packages/common/pdsClient/` Common PDS client used by the lambda functions\n- `packages/common/commonTypes/` Common types used throughout the lambda functions\n- `packages/common/lambdaUtils/` Common utils used by the lambda functions\n- `packages/common/testing/` Common testing utils used by the lambda functions\n- `packages/common/authFunctions/` Common auth functions used by the lambda functions\n- `scripts/` Utilities helpful to developers of this specification.\n- `.devcontainer` Contains a dockerfile and vscode devcontainer definition.\n- `.github` Contains github workflows that are used for building and deploying from pull requests and releases.\n- `.vscode` Contains vscode workspace file.\n\n\n## Contributing\n\nContributions to this project are welcome from anyone, providing that they conform to the [guidelines for contribution](https://github.com/NHSDigital/eps-prescription-tracker-ui/blob/main/CONTRIBUTING.md) and the [community code of conduct](https://github.com/NHSDigital/eps-prescription-tracker-ui/blob/main/CODE_OF_CONDUCT.md).\n\n### Licensing\n\nThis code is dual licensed under the MIT license and the OGL (Open Government License). Any new work added to this repository must conform to the conditions of these licenses. In particular this means that this project may not depend on GPL-licensed or AGPL-licensed libraries, as these would violate the terms of those libraries' licenses.\n\nThe contents of this repository are protected by Crown Copyright (C).\n\n## Development\n\nIt is recommended that you use visual studio code and a devcontainer as this will install all necessary components and correct versions of tools and languages.\nSee https://code.visualstudio.com/docs/devcontainers/containers for details on how to set this up on your host machine.\nThere is also a workspace file in .vscode that should be opened once you have started the devcontainer. The workspace file can also be opened outside of a devcontainer if you wish.\n\nAll commits must be made using [signed commits](https://docs.github.com/en/authentication/managing-commit-signature-verification/signing-commits)\n\nOnce the steps at the link above have been completed. Add to your ~/.gnupg/gpg.conf as below:\n\n```\nuse-agent\npinentry-mode loopback\n```\n\nand to your ~/.gnupg/gpg-agent.conf as below:\n\n```\nallow-loopback-pinentry\n```\n\nAs described here:\nhttps://stackoverflow.com/a/59170001\n\nYou will need to create the files, if they do not already exist.\nThis will ensure that your VSCode bash terminal prompts you for your GPG key password.\n\nYou can cache the gpg key passphrase by following instructions at https://superuser.com/questions/624343/keep-gnupg-credentials-cached-for-entire-user-session\n\n### Setup\n\nEnsure you have the following lines in the file .envrc\n\n```\nexport AWS_DEFAULT_PROFILE=prescription-dev\n```\n\nOnce you have saved .envrc, start a new terminal in vscode and run this command to authenticate against AWS\n\n```\nmake aws-configure\n```\n\nPut the following values in:\n\n```\nSSO session name (Recommended): sso-session\nSSO start URL [None]: \u003cUSE VALUE OF SSO START URL FROM AWS LOGIN COMMAND LINE ACCESS INSTRUCTIONS ACCESSED FROM https://myapps.microsoft.com\u003e\nSSO region [None]: eu-west-2\nSSO registration scopes [sso:account:access]:\n```\n\nThis will then open a browser window and you should authenticate with your hscic credentials\nYou should then select the development account and set default region to be eu-west-2.\n\nYou will now be able to use AWS and CDK CLI commands to access the dev account. You can also use the AWS extension to view resources.\n\nWhen the token expires, you may need to reauthorise using `make aws-login`\n\n### Running website locally and syncing CDK\n\nTo speed up feedback time during development, you can run the website locally and automatically sync any cdk changes automatically to AWS.  \nYou must have already created a pull request for your branch to set up the initial CDK infrastructure.\n\nOnce this is done, you can run\n```\nmake cdk-watch\n```\nand enter the pull request id (just the number)\nLog files are written to at\n- .local_config/stateful_app.log\n- .local_config/stateless_app.log\n- .local_config/website.log\n\nYou should monitor the stateful and stateless log files as it can take a few minutes for the sync to complete.   \nThis runs cdk watch against the stateless and stateful stacks, and also starts the website running locally which you can access at http://localhost:3000\n\n\n###  React app\nReact code resides in packages/cpt-ui folder.  \n\n### CI Setup\n\nThe GitHub Actions require a secret to exist on the repo called \"SONAR_TOKEN\".\nThis can be obtained from [SonarCloud](https://sonarcloud.io/)\nas described [here](https://docs.sonarsource.com/sonarqube/latest/user-guide/user-account/generating-and-using-tokens/).\nYou will need the \"Execute Analysis\" permission for the project (NHSDigital_electronic-prescription-service-clinical-prescription-tracker) in order for the token to work.\n\n### Pre-commit hooks\n\nSome pre-commit hooks are installed as part of the install above, to run basic lint checks and ensure you can't accidentally commit invalid changes.\nThe pre-commit hook uses python package pre-commit and is configured in the file .pre-commit-config.yaml.\nA combination of these checks are also run in CI.\n\n### Make commands\n\nThere are `make` commands that are run as part of the CI pipeline and help alias some functionality during development.\n\n#### install targets\n\n- `install-node` Installs node dependencies\n- `install-python` Installs python dependencies\n- `install-hooks` Installs git pre commit hooks\n- `install` Runs all install targets\n\n#### CDK targets\n\nThese are used to do common commands related to cdk\n\n- `cdk-deploy` Builds and deploys the code to AWS\n- `cdk-synth` Converts the CDK code to cloudformation templates\n- `cdk-diff` Runs cdk diff comparing the deployed stack with local CDK code to see differences\n- `cdk-watch` Syncs the code and CDK templates to AWS, and starts local webserver. This keeps running and automatically uploads changes to AWS\n\n#### Clean and deep-clean targets\n\n- `clean` Clears up any files that have been generated by building or testing locally.\n- `deep-clean` Runs clean target and also removes any node_modules and python libraries installed locally.\n\n#### Linting and testing\n\n- `lint` Runs lint for all code\n- `lint-node` Runs lint for node code\n- `test` Runs unit tests for all code\n- `cfn-guard` runs cfn-guard for cloudformation templates generated by cdk synth\n\n#### Compiling\n\n- `compile` Compiles all code\n- `compile-node` Runs tsc to compile typescript code\n\n#### Check licenses\n\n- `check-licenses` Checks licenses for all packages used - calls check-licenses-node, check-licenses-python\n- `check-licenses-node` Checks licenses for all node code\n- `check-licenses-python` Checks licenses for all python code\n\n#### CLI Login to AWS\n\n- `aws-configure` Configures a connection to AWS\n- `aws-login` Reconnects to AWS from a previously configured connection\n\n#### React App\n- `react-dev` Starts app in dev mode on localhost\n- `react-build` Generates static files in .next folder\n- `react-start` Starts app in production mode using build-generated static files\n\n### Github folder\n\nThis .github folder contains workflows and templates related to GitHub, along with actions and scripts pertaining to Jira.\n\n- `pull_request_template.md` Template for pull requests.\n- `dependabot.yml` Dependabot definition file.\n\nActions are in the `.github/actions` folder:\n\n- `mark_jira_released` Action to mark Jira issues as released.\n- `update_confluence_jira` Action to update Confluence with Jira issues.\n\nScripts are in the `.github/scripts` folder:\n\n- `call_mark_jira_released.sh` Calls a Lambda function to mark Jira issues as released.\n- `create_env_release_notes.sh` Generates release notes for a specific environment using a Lambda function.\n- `create_int_rc_release_notes.sh` Creates release notes for integration environment using a Lambda function.\n- `delete_stacks.sh` Checks and deletes active CloudFormation stacks associated with closed pull requests.\n- `get_current_dev_tag.sh` Retrieves the current development tag and sets it as an environment variable.\n- `get_target_deployed_tag.sh` Retrieves the currently deployed tag and sets it as an environment variable.\n\nWorkflows are in the `.github/workflows` folder:\n\n- `ci.yml` Workflow that runs on merges to main branch and releases to dev and qa environments.\n- `delete_old_cloudformation_stacks.yml` Workflow for deleting old cloud formation stacks. Runs daily.\n- `dependabot_auto_approve_and_merge.yml` Workflow to auto merge dependabot updates.\n- `pr_title_check.yml` This workflow checks the pull request title has the correct format.\n- `pr-link.yml` This workflow template links Pull Requests to Jira tickets and runs when a pull request is opened.\n- `pull_request.yml` Called when pull request is opened or updated. Calls package_code and release_code to build and deploy the code. Deploys to dev AWS account. The main stack deployed adopts the naming convention cpt-ui-pr-\u003cPULL_REQUEST_ID\u003e\n- `quality_checks.yml` Runs check-licenses, lint, test and SonarCloud scan against the repo. Called from pull_request.yml and release.yml\n- `release.yml` Creates a new release tag and deploys to all environments\n- `cdk_package_code.yml` Packages code into a docker image and uploads to a github artifact for later deployment.\n- `cdk_release_code.yml` Release code built by cdk_package_code.yml to an environment.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fnhsdigital%2Feps-prescription-tracker-ui","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fnhsdigital%2Feps-prescription-tracker-ui","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fnhsdigital%2Feps-prescription-tracker-ui/lists"}