{"id":21128805,"url":"https://github.com/dreamfactorysoftware/df-admin-interface","last_synced_at":"2026-02-23T13:20:19.588Z","repository":{"id":185165767,"uuid":"673044402","full_name":"dreamfactorysoftware/df-admin-interface","owner":"dreamfactorysoftware","description":null,"archived":false,"fork":false,"pushed_at":"2024-05-28T02:05:11.000Z","size":36264,"stargazers_count":1,"open_issues_count":8,"forks_count":2,"subscribers_count":6,"default_branch":"main","last_synced_at":"2024-05-28T11:59:40.967Z","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":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/dreamfactorysoftware.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":"2023-07-31T18:34:44.000Z","updated_at":"2024-05-30T06:34:57.685Z","dependencies_parsed_at":null,"dependency_job_id":"89395f81-906b-4296-94a9-f0876769bf65","html_url":"https://github.com/dreamfactorysoftware/df-admin-interface","commit_stats":null,"previous_names":["dreamfactorysoftware/df-admin-interface"],"tags_count":8,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dreamfactorysoftware%2Fdf-admin-interface","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dreamfactorysoftware%2Fdf-admin-interface/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dreamfactorysoftware%2Fdf-admin-interface/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dreamfactorysoftware%2Fdf-admin-interface/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/dreamfactorysoftware","download_url":"https://codeload.github.com/dreamfactorysoftware/df-admin-interface/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":225470726,"owners_count":17479368,"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-11-20T05:02:59.020Z","updated_at":"2026-01-21T14:11:54.223Z","avatar_url":"https://github.com/dreamfactorysoftware.png","language":"TypeScript","funding_links":[],"categories":["TypeScript"],"sub_categories":[],"readme":"# DreamFactory Admin Interface\n\nAdmin interface for managing DreamFactory instance.\n\n## Table of Contents\n\n- [Getting Started](#getting-started)\n  - [Prerequisites](#prerequisites)\n  - [Installation](#installation)\n- [Usage](#usage)\n  - [Development](#development)\n  - [Linting and Formatting](#linting-and-formatting)\n    - [Lint](#lint)\n    - [Lint and Fix](#lint-and-fix)\n    - [Format](#format)\n- [Running the tests](#running-the-tests)\n  - [Run Unit Tests](#run-unit-tests)\n  - [Run and Watch Unit Tests](#run-and-watch-unit-tests)\n  - [Run Unit Tests with Coverage](#run-unit-tests-with-coverage)\n- [Building the Project](#building-the-project)\n- [Adding additional languages](#adding-additional-languages)\n\n## Getting Started\n\n### Prerequisites\n\n- Node.js \u003e=16.14.0\n- Angular CLI\n\n### Installation\n\n```\nnpm install\n```\n\n#### Install husky\n\n[husky](https://typicode.github.io/husky/) is used to run git hooks for formatting and linting checking code prior to commiting code. To install husky run the following command:\n\n```\nnpm run prepare\n```\n\n## Usage\n\n### Development\n\n```\nnpm start\n```\n\nProxying to DreamFactory instance is configured in [proxy.conf.json](./proxy.conf.json).\n\n### Linting and Formatting\n\n#### Lint\n\n```\nnpm run lint\n```\n\n#### Lint and Fix\n\n```\nnpm run lint:fix\n```\n\n#### Format\n\n```\nnpm run prettier\n```\n\n## Running the tests\n\n[jest](https://jestjs.io/) is used for unit testing. Tests are named with the following convention: [name].spec.ts\n\n#### Run Unit Tests\n\n```\nnpm run test\n```\n\n#### Run and Watch Unit Tests\n\n```\nnpm run test:watch\n```\n\n#### Run Unit Tests with Coverage\n\n```\nnpm run test:coverage\n```\n\n## Building the Project\n\n```\nnpm run build\n```\n\n## Adding additional languages\n\nWhen more than one language is supported, the language selector will be displayed in the top right corner of the application.\n\n- User language will be detected from preference provided by browser. If browser preference is a supported language it will be selected by default.\n- If language selector is enabled and user change language manually, their preference is stored in `localStorage` for future reference. If language preference is found in `localStorage`, than it is treated as default language.\n\n- To add a new language, follow these steps:\n  1. Add a new entry to the `SUPPORTED_LANGUAGES` array in [src/app/shared/constants/languages.ts](src/app/shared/constants/languages.ts).\n     - code: The language code. This is used to identify the language in the application.\n     - altCode: Alternative language code that might be provided by browser. eg en-US, en-CA.\n  2. Create new translation files in [src/assets/i18n](./src/assets/i18n/) and every sub-folder.\n     - Ensure label for languages are created in alternative language in [src/assets/i18n/en.json](src/assets/i18n/en.json)\n       ```json\n       \"languages\": {\n         \"en\": \"English\"\n       }\n       ```\n     - These are used to display language label in dropdown.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdreamfactorysoftware%2Fdf-admin-interface","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fdreamfactorysoftware%2Fdf-admin-interface","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdreamfactorysoftware%2Fdf-admin-interface/lists"}