{"id":23832177,"url":"https://github.com/linagora/esn-frontend-calendar","last_synced_at":"2025-09-07T11:31:46.794Z","repository":{"id":40298631,"uuid":"276895569","full_name":"linagora/esn-frontend-calendar","owner":"linagora","description":"Calendar SPA for the OpenPaaS Suite - https://open-paas.org/","archived":false,"fork":false,"pushed_at":"2023-10-27T13:16:22.000Z","size":1476,"stargazers_count":8,"open_issues_count":106,"forks_count":15,"subscribers_count":12,"default_branch":"main","last_synced_at":"2024-04-14T10:13:31.966Z","etag":null,"topics":["spa"],"latest_commit_sha":null,"homepage":"","language":"JavaScript","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/linagora.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}},"created_at":"2020-07-03T12:33:02.000Z","updated_at":"2022-01-10T08:56:27.000Z","dependencies_parsed_at":"2022-08-09T16:45:17.831Z","dependency_job_id":null,"html_url":"https://github.com/linagora/esn-frontend-calendar","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/linagora%2Fesn-frontend-calendar","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/linagora%2Fesn-frontend-calendar/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/linagora%2Fesn-frontend-calendar/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/linagora%2Fesn-frontend-calendar/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/linagora","download_url":"https://codeload.github.com/linagora/esn-frontend-calendar/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":232206427,"owners_count":18488519,"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":["spa"],"created_at":"2025-01-02T14:18:20.787Z","updated_at":"2025-01-02T14:18:23.487Z","avatar_url":"https://github.com/linagora.png","language":"JavaScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# esn-frontend-calendar\n\nCalendar application for OpenPaaS\n\n## Development\n\n### Configuration\n\nFirst, you want to ensure that the application grid component is provided with the necessary information about the apps via the environment variable `APP_GRID_ITEMS`:\n\n```sh\ncp .env.example .env\n```\n\n- **APP_GRID_ITEMS**: A stringified JSON representation of the apps to show in the application grid. It has the following shape:\n  ```json\n  [\n    { \"name\": \"Inbox\", \"url\": \"http://localhost:9900/#/unifiedinbox/inbox\" },\n    { \"name\": \"Calendar\", \"url\": \"http://localhost:9900/#/calendar\" },\n    ...\n  ]\n  ```\n\nThen, launch the dev server on http://localhost:9900:\n\n```sh\nOPENPAAS_URL=https://dev.open-paas.org npm run serve\n```\n\n- **OPENPAAS_URL**: The OpenPaaS URL to be used by the current SPA application. Defaults to `http://localhost:8080`.\n\nThe development server can also be used to serve minified SPA to check that everything is OK:\n\n```sh\nOPENPAAS_URL=https://dev.open-paas.org npm run serve:prod\n```\n\n### Authentication\n\nAuthentication is provided by a dedicated SPA [esn-frontend-login-app](https://github.com/OpenPaaS-Suite/esn-frontend-login) which is defined in the project `devDependencies`.\nIn order to make it work with the webpack-dev-server launched by the `npm run serve` command, you will have to generate it like this:\n\n```sh\ncd ./node_modules/esn-frontend-login \u0026\u0026 npm install \u0026\u0026 npm run build\n```\n\n### Serve\n\nGo to http://localhost:9900/calendar/ to open the SPA\n\n## Build\n\nGenerates minified SPA in the `./dist` folder:\n\n```sh\nnpm run build:prod\n```\n\nRegarding **APP_GRID_ITEMS**, you can also provide it as a system variable for production purposes, e.g.:\n\n```sh\nAPP_GRID_ITEMS=\"[{ \\\"name\\\": \\\"Calendar\\\", \\\"url\\\": \\\"https://dev.open-paas.org/calendar/\\\" }, { \\\"name\\\": \\\"Contacts\\\", \\\"url\\\": \\\"https://dev.open-paas.org/contacts/\\\" }, { \\\"name\\\": \\\"Inbox\\\", \\\"url\\\": \\\"http://dev.open-paas.org/inbox/\\\" }, { \\\"name\\\": \\\"Admin\\\", \\\"url\\\": \\\"https://dev.open-paas.org/admin/\\\" }, { \\\"name\\\": \\\"LinShare\\\", \\\"url\\\": \\\"https://user.linshare-4-0.integration-linshare.org/\\\" }]\" npm run build:prod\n```\n\n## Running tests\n\nYou can run tests by executing the following command:\n\n```sh\nnpm run test\n```\n\nNote that there is a 10000ms timeout by default. If you want to change that, simply pass the **TEST_TIMEOUT** environment variable:\n\n```sh\nTEST_TIMEOUT=2000 npm run test\n```\n\n# Debugging tests\n\nYou can debug tests on VSCode with Chrome by executing the following command:\n\n```sh\nnpm run test:debug\n```\n\nThen you have to add the following configuration to you `launch.json` and then run it (F5):\n\n```json\n{\n  \"name\": \"Attach to Chrome\",\n  \"port\": 9222,\n  \"request\": \"attach\",\n  \"type\": \"pwa-chrome\",\n}\n```\n\nThis will let you use breakpoints on the application. Save a file to make tests run again.","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Flinagora%2Fesn-frontend-calendar","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Flinagora%2Fesn-frontend-calendar","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Flinagora%2Fesn-frontend-calendar/lists"}