{"id":23066835,"url":"https://github.com/dvsa/des-mobile-app","last_synced_at":"2025-08-15T11:33:31.203Z","repository":{"id":37749297,"uuid":"300617757","full_name":"dvsa/des-mobile-app","owner":"dvsa","description":"An application for DVSA driving examiners to conduct driving tests digitally","archived":false,"fork":false,"pushed_at":"2024-12-11T11:30:49.000Z","size":29421,"stargazers_count":6,"open_issues_count":14,"forks_count":3,"subscribers_count":4,"default_branch":"develop","last_synced_at":"2024-12-11T11:36:55.004Z","etag":null,"topics":["angular","capacitor","ionic","typescript"],"latest_commit_sha":null,"homepage":"","language":"TypeScript","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/dvsa.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2020-10-02T13:08:33.000Z","updated_at":"2024-12-11T10:44:42.000Z","dependencies_parsed_at":"2022-07-08T04:49:41.259Z","dependency_job_id":"2cf9c657-5dab-43f2-9fd0-f8c20500a2a0","html_url":"https://github.com/dvsa/des-mobile-app","commit_stats":null,"previous_names":[],"tags_count":109,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dvsa%2Fdes-mobile-app","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dvsa%2Fdes-mobile-app/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dvsa%2Fdes-mobile-app/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dvsa%2Fdes-mobile-app/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/dvsa","download_url":"https://codeload.github.com/dvsa/des-mobile-app/tar.gz/refs/heads/develop","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":229910957,"owners_count":18143229,"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":["angular","capacitor","ionic","typescript"],"created_at":"2024-12-16T05:15:06.571Z","updated_at":"2024-12-16T05:15:07.161Z","avatar_url":"https://github.com/dvsa.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# DES Mobile App\n\nDVSA Driving Examiner Application\n\n![CI Checks](https://github.com/dvsa/des-mobile-app/actions/workflows/ci.yaml/badge.svg)\n![Snyk Security](https://github.com/dvsa/des-mobile-app/actions/workflows/security.yaml/badge.svg)\n\n### Pre-requisites\n\n- NodeJS - We are using [n](https://github.com/tj/n) to manage our version. Please see `.nvmrc` for specific version\n- NPM (If using [n](https://github.com/tj/n), your `npm` version will be automatically managed)\n- Brew\n- Cocoapods (Recommend installing via Homebrew using `brew install cocoapods`)\n- Security\n  - [Git secrets](https://github.com/awslabs/git-secrets)\n  - [ScanRepo](https://github.com/UKHomeOffice/repo-security-scanner)\n    - Unzip `repo-security-scanner_\u003cversion\u003e_Darwin_\u003carchitercture\u003e.tar.gz` and rename the executable inside the folder\n      to `scanrepo` - Add executable to path (using `echo $PATH` to find your path)\n\n- NOTE: You wil need to obtain `ionic.config.json` and `.npmrc` files containing secrets and save to the\n  project root in order to build the app.\n\n### Get started\n\n###### Run the following commands after cloning the project\n\n1. `npm install` (or `npm i`)\n2. `npm run build`\n\n### Config\n\n###### Run the following to switch between configurations\n\n- `npm run config:dev`\n- `npm run config:local`\n\n### Running Application\n\n- For simulator/device (A list of devices will be displayed based on Xcode installations)\n  - `npm run serve:emulator`\n- For browser (Opens in default browser using data from `./mocks/generate-local-*.ts` files)\n  - `npm run serve:local`\n\n### Accessing NGRX state\n\n###### The Redux DevTools extension can be installed via Chrome Web Store\n\n#### Browser:\n\n- Open ReduxDevTools\n\n#### Simulator:\n\n1. In one terminal: `npm run remote-devtools-server`\n2. In another: `npm run serve:devtools`\n3. Open remote devtools from ReduxDevTools Chrome extension\n4. Open `settings` (first use only) and set option for `Use custom (local) server`. `Host name: localhost Port: 8000`\n\n### Unit Tests\n\n###### Running the following command will execute the unit test suite, as well as creating a folder containing code coverage here `./coverage`.\n\n- `npm run test`\n\n### Sentry\n\n###### In order to manually create a Sentry release, you should obtain the `.sentryclirc` file and place at root\n\n- A script has been added (`buildScripts/sentry-deploy.sh`) that will automatically create a new Sentry release and\n  upload sourcemaps\n- If wishing to disable Sentry for any reason, then set the `dsn` value to null in the env file\n\n### Sonar\n\n###### In order to upload latest code to Sonar, you should obtain the `sonar-project.properties` file and place at root\n\n- A script has been added (`buildScripts/sonar-properties-update.sh`) that will update the version of the Sonar release\n  based upon the version contained inside `config.xml`\n- Execute `npm run sonar` to ensure all necessary files are checked\n\n### Code style\n\n- This project uses [husky](https://github.com/typicode/husky) to run a series of checks on `pre-commit` and `pre-push`\n- This project uses `biome` to enforce code styles/standards.  Plugins are available for code editors such as webstorm and vscode\n\n###### Use the following to trigger a code wide review.\n- - `npm run lint`\n- - `npm run lint:fix`\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdvsa%2Fdes-mobile-app","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fdvsa%2Fdes-mobile-app","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdvsa%2Fdes-mobile-app/lists"}