{"id":18608784,"url":"https://github.com/activeviam/activeui4.3.16-developertraining","last_synced_at":"2025-11-02T18:30:33.937Z","repository":{"id":47252076,"uuid":"403705354","full_name":"activeviam/ActiveUI4.3.16-developerTraining","owner":"activeviam","description":null,"archived":false,"fork":false,"pushed_at":"2021-12-13T11:06:20.000Z","size":12122,"stargazers_count":1,"open_issues_count":0,"forks_count":1,"subscribers_count":3,"default_branch":"main","last_synced_at":"2024-12-27T01:10:00.308Z","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":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/activeviam.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":null,"support":null}},"created_at":"2021-09-06T17:21:22.000Z","updated_at":"2022-08-03T13:36:38.000Z","dependencies_parsed_at":"2022-09-12T11:20:23.232Z","dependency_job_id":null,"html_url":"https://github.com/activeviam/ActiveUI4.3.16-developerTraining","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/activeviam%2FActiveUI4.3.16-developerTraining","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/activeviam%2FActiveUI4.3.16-developerTraining/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/activeviam%2FActiveUI4.3.16-developerTraining/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/activeviam%2FActiveUI4.3.16-developerTraining/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/activeviam","download_url":"https://codeload.github.com/activeviam/ActiveUI4.3.16-developerTraining/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":239399814,"owners_count":19632022,"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-07T03:04:19.735Z","updated_at":"2025-11-02T18:30:33.737Z","avatar_url":"https://github.com/activeviam.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"### About\n\nThis project provides a minimal application based on [ActiveUI SDK](https://activeviam.com/activeui/documentation).\n\n### Before you start\n\nYou must install the following tools:\n\n- [Node.js](https://nodejs.org) the JS engine running the scripts.\n- [Yarn](https://yarnpkg.com) for dependency management. We recommend using Yarn instead of [npm](https://www.npmjs.com/), but you can use npm if you prefer.\n\nPlease find the minimal required versions in `package.json` of the starter package.\n\n### Scripts\n\nThis module was bootstrapped with [Create React App](https://github.com/facebook/create-react-app) and is setup with [ESLint](https://eslint.org/) and [Prettier](https://prettier.io/) to help you write clean and consistently formatted code.\n\nThe following commands are available:\n\n- `yarn start` runs the app in development mode using Create React App's ['start' script](https://facebook.github.io/create-react-app/docs/available-scripts#npm-start).\n- `yarn build` builds the app for production using Create React App's ['build' script](https://facebook.github.io/create-react-app/docs/available-scripts#npm-run-build).\n- `yarn test` launches the tests using Create React App's ['test' script](https://facebook.github.io/create-react-app/docs/available-scripts#npm-test).\n- `yarn check-style` lists the files that should be reformatted using [Prettier](https://prettier.io/).\n- `yarn fix-style` reformats all files using [Prettier](https://prettier.io/).\n\n### IDE Setup\n\nIf you are using VS Code, you can install the [ESLint](https://marketplace.visualstudio.com/items?itemName=dbaeumer.vscode-eslint) and [Prettier](https://marketplace.visualstudio.com/items?itemName=esbenp.prettier-vscode) plugins and leverage these tools by adopting the following settings:\n\n```js\n\"eslint.alwaysShowStatus\": true, // To get improvements suggestions on the fly.\n\"eslint.autoFixOnSave\": true,    // To automatically improve your code when it can be.\n\"editor.formatOnSave\": true,     // To format automatically.\n```\n\n### Dependencies\n\nBesides [ActiveUI SDK](https://activeviam.com/activeui/documentation), this application comes with the following main runtime dependencies:\n\n- [React](https://reactjs.org/): a JavaScript library for building user interfaces.\n- [Ant Design](https://ant.design/): a design system and React UI library that contains a set of high quality components for building rich, interactive user interfaces.\n- [Emotion](https://emotion.sh): a library designed for writing css styles with JavaScript.\n\n### End-to-end testing\n\nA [Cypress](https://docs.cypress.io/) setup is available, allowing you to add end-to-end tests to the application.\nWe've written on why we prefer Cypress over some other solutions [in a blog post](https://activeviam.com/blog/puppeteer-vs-cypress-best-end-end-testing/).\nTwo commands are available to run the tests:\n\n- `yarn test-e2e` runs all tests headlessly in an Electron browser.\n- `yarn test-e2e-debug` opens an interactive window allowing you to choose which test(s) you want to run.\n\nAn example test is available in `cypress/integration/dashboards-drawer.spec.js`.\nIn `cypress/support/addLoginCommand.js`, you will find an example of a custom Cypress command to login into the application.\nTo run the existing test, you will first need to specify your server url, as well as the application credentials as environment variables in `cypress.env.json`.\n\n### Environment-Specific Configuration\n\nYou can configure your ActivePivot URL and others through environment variables, query parameters, or variables defined on window.\n\n#### Query Parameters\n\n- `url` - Can be used to override all other server URLs.\n- `activePivotServerUrl` - ActivePivot server URL.\n- `activeMonitorServerUrl` - ActiveMonitor server URL.\n- `contentServerUrl` - Content server URL.\n\n#### Environment Variables\n\n- `REACT_APP_ACTIVE_PIVOT_SERVER_URL` - ActivePivot server URL.\n- `REACT_APP_ACTIVE_MONITOR_SERVER_URL` - ActiveMonitor server URL.\n- `REACT_APP_CONTENT_SERVER_URL` - Content server URL.\n\n#### Variables on Window\n\nIn some situations you may be required to deploy a single build to different environments and have it target different URLs.\nIn this case the URL must be defined at runtime.\nThere are two builtin ways to accomplish this. One is using query parameters.\nThe other is using `.js` files that are not compiled, and are served directly.\n\nFor this app you can define Environment variables within the `env.*.js` files under `public`.\n\n- `window.env.activePivotServerUrl` - ActivePivot server URL.\n- `window.env.activeMonitorServerUrl` - ActiveMonitor server URL.\n- `window.env.contentServerUrl` - Content server URL.\n\n#### Precedence Order\n\n- `url` query parameter.\n- Specific query parameter, e.g. `activePivotServerUrl`.\n- Specific variable on window, e.g. `window.env.activePivotServerUrl`.\n- Specific environment variables, e.g. `REACT_APP_ACTIVE_PIVOT_SERVER_URL`.\n- If none of those are defined then we fallback to connecting to the base URL the app is served at.\n  e.g. If the app is served at `http://example.com:8080/app` then we will try to connect to `http://example.com:8080`.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Factiveviam%2Factiveui4.3.16-developertraining","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Factiveviam%2Factiveui4.3.16-developertraining","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Factiveviam%2Factiveui4.3.16-developertraining/lists"}