{"id":50503360,"url":"https://github.com/1111philo/apolis-app","last_synced_at":"2026-06-02T13:30:59.903Z","repository":{"id":273428840,"uuid":"919695647","full_name":"1111philo/apolis-app","owner":"1111philo","description":"Harry Tompson Center Dashboard AKA \"Apolis\" - the app that replaces clipboards.","archived":false,"fork":false,"pushed_at":"2025-03-25T20:52:41.000Z","size":1021,"stargazers_count":7,"open_issues_count":16,"forks_count":0,"subscribers_count":3,"default_branch":"main","last_synced_at":"2025-03-25T21:33:05.652Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/1111philo.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","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":"2025-01-20T20:51:03.000Z","updated_at":"2025-03-17T16:06:09.000Z","dependencies_parsed_at":"2025-02-06T21:29:54.342Z","dependency_job_id":"e5062f16-92da-4b47-b814-44e8d98a2e39","html_url":"https://github.com/1111philo/apolis-app","commit_stats":null,"previous_names":["1111philo/htc-dashboard","1111philo/htc-app","1111philo/apolis-app"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/1111philo/apolis-app","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/1111philo%2Fapolis-app","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/1111philo%2Fapolis-app/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/1111philo%2Fapolis-app/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/1111philo%2Fapolis-app/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/1111philo","download_url":"https://codeload.github.com/1111philo/apolis-app/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/1111philo%2Fapolis-app/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":33824897,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-26T15:22:16.424Z","status":"online","status_checked_at":"2026-06-02T02:00:07.132Z","response_time":109,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"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":"2026-06-02T13:30:55.798Z","updated_at":"2026-06-02T13:30:59.894Z","avatar_url":"https://github.com/1111philo.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003ca id=\"readme-top\"\u003e\u003c/a\u003e\n\n\u003c!-- PROJECT SHIELDS --\u003e\n\u003c!--\n*** I'm using markdown \"reference style\" links for readability.\n*** Reference links are enclosed in brackets [ ] instead of parentheses ( ).\n*** See the bottom of this document for the declaration of the reference variables\n*** for contributors-url, forks-url, etc. This is an optional, concise syntax you may use.\n*** https://www.markdownguide.org/basic-syntax/#reference-style-links\n--\u003e\n[![Contributors][contributors-shield]][contributors-url] [![Stargazers][stars-shield]][stars-url] [![Issues][issues-shield]][issues-url] [![project_license][license-shield]][license-url]\n\n\n\u003c!-- PROJECT LOGO --\u003e\n\u003cbr /\u003e\n\u003cdiv align=\"center\"\u003e\n  \u003c!-- \u003ca href=\"https://github.com/github_username/repo_name\"\u003e\n    \u003cimg src=\"images/logo.png\" alt=\"Logo\" width=\"80\" height=\"80\"\u003e\n  \u003c/a\u003e --\u003e\n\n\u003ch1 align=\"center\"\u003eapolis\u003c/h1\u003e\n\n  \u003cp align=\"center\"\u003e\n    Guest, service, and data management app for the Harry Tompson Center, an outreach organization for the unhoused.\n    \u003cbr /\u003e\n    \u003ca href=\"https://github.com/1111philo/apolis-app/issues/new?template=bug_report.md\"\u003eReport Bug\u003c/a\u003e\n    \u0026middot;\n    \u003ca href=\"https://github.com/1111philo/apolis-app/issues/new?template=feature_request.md\"\u003eRequest Feature\u003c/a\u003e\n  \u003c/p\u003e\n\u003c/div\u003e\n\n\n\u003c!-- ABOUT THE PROJECT --\u003e\n## About The Project\n\nThe Harry Tompson Center in New Orleans, LA, US provides services for the unhoused. They regularly service 35,000+ visits and 4,000+ unique visitors every year. This app replaces their manual clipboard workflow, improving accuracy and ease of tracking their guests and impact in the community.\n\nLive [staging deployment](https://apolis.dev/).\n\n### Tech Stack\n\n#### Frontend ([https://github.com/1111philo/apolis-app](https://github.com/1111philo/apolis-app))\n- [React](https://react.dev/) based single page application\n- File-based routing with [TanStack Router](https://tanstack.com/router/latest)\n- [React-Bootstrap](https://react-bootstrap.github.io/) for UI components\n- [Vite](https://vite.dev/) for building.\n- Deployment: GitHub Actions to S3 and CloudFront\n\n#### API ([https://github.com/1111philo/apolis-api](https://github.com/1111philo/apolis-api))\n- [Node.js](https://nodejs.org/en) serverless functions on [AWS Lambda](https://aws.amazon.com/lambda/)\n- Authentication: [Amazon Cognito](https://aws.amazon.com/pm/cognito/)\n- Supports `GET` and `POST` requests\n\n#### DB ([https://github.com/1111philo/apolis-db](https://github.com/1111philo/apolis-db))\n- [PostgreSQL](https://www.postgresql.org/)\n- SQL queries for local setup\n#### video\n- [Video overview of our stack as of 2/4/24](https://us06web.zoom.us/rec/share/L3O6v3vV6wljV0SJz87CeLvevRfK3V4z4Y5GlkSzXD4QPnjrApQiDk4xtUni1krd.2k59v7DioKcRWm9H) - also has general walkthrough of the app\n\n\u003cp align=\"right\"\u003e(\u003ca href=\"#readme-top\"\u003eback to top\u003c/a\u003e)\u003c/p\u003e\n\n\n\n\u003c!-- GETTING STARTED --\u003e\n## Getting Started\n\nTo get a local copy up and running follow the steps below.\n\n### Prerequisites\n\nBefore running locally and/or working on **apolis**, you need installed:\n- [git](https://git-scm.com/downloads)\n- [node.js](https://nodejs.org/en/download)\n- [pnpm](https://pnpm.io/installation) (or [npm](https://docs.npmjs.com/downloading-and-installing-node-js-and-npm) or [yarn](https://yarnpkg.com/getting-started/install))\n\n### Installation\n\n1. Clone the repo:\n   ```sh\n   git clone https://github.com/1111philo/apolis-app.git\n   ```\n2. Switch from the `main` branch to the `staging` branch. **This is the development branch, base all your working branches off** `staging`.\n    ```sh\n    git switch staging\n    ```\n3. Install npm packages:\n   ```sh\n   pnpm install\n   ```\n4. Run the app in the local staging environment:\n   ```sh\n   pnpm run start:staging\n   ```\n\n#### User credentials for development\n\n**Users:** `admin@apolis.app`, `manager@apolis.app`,\n**Pass:** `apolis` (works for all)\n\n\u003cp align=\"right\"\u003e(\u003ca href=\"#readme-top\"\u003eback to top\u003c/a\u003e)\u003c/p\u003e\n\n\n\n\u003c!-- INFO ON API --\u003e\n## API\n\nThe values located in `/.env.staging` and `/.env.production` are used to interact with the respective API (staging and production environments have their own API).\n\n### Usage with Postman\n\nSee our Postman collection [here](https://docs.apolis.dev/).\nThe following steps are also covered in this [video](https://us06web.zoom.us/rec/share/z2HiTTEZ5q0Ebchj-eEwUpbwNeTWVv6TnLPBe8u3Z3VlvmbKriY4KUcyPHM7JK2K.RXsD-qNqN_CbaS6z) (passcode: \\^D7^8@rh).\n\n1. Download the collection (or run Postman in the browser) by clicking the \"Run in Postman\" button at the top right of the [docs page](https://docs.apolis.dev/).\n\n**To send requests to the API, you must have an authentication token.**\n\n2. Under `/Public`, send the `Get Auth Token` request. You will receive a response like this:\n    ```json\n    {\n      \"IdToken\": \"\u003cstring\u003e\",\n      \"RefreshToken\": \"\u003cstring\u003e\",\n      \"AccessToken\": \"\u003cstring\u003e\"\n    }\n    ```\n3. Highlight the string value of the `IdToken` field (quotes not included), right click the selection, click \"Set as variable\", choose the `token` variable.\n\u003cbr /\u003e\n    \u003e ⚠️ *if you don't see the* `token` *variable, ensure you are working in the* `Staging` *environment (there's a dropdown at the top right in the Postman app to choose the environment)*\n\u003cbr /\u003e\n4. You are now authorized to send any API requests under the `/Auth` folder.\n\n\u003cp align=\"right\"\u003e(\u003ca href=\"#readme-top\"\u003eback to top\u003c/a\u003e)\u003c/p\u003e\n\n\n\u003c!-- CONTRIBUTING --\u003e\n## Looking to Contribute?\n\nSee our [CONTRIBUTING.md](https://github.com/1111philo/apolis-app/blob/main/CONTRIBUTING.md).\n\n\n### Top contributors:\n\n\u003ca href=\"https://github.com/1111philo/apolis-app/graphs/contributors\"\u003e\n  \u003cimg src=\"https://contrib.rocks/image?repo=1111philo/apolis-app\" alt=\"contrib.rocks image\" /\u003e\n\u003c/a\u003e\n\n\n\u003c!-- ROADMAP --\u003e\n## Roadmap\n\nSee the [open issues](https://github.com/1111philo/apolis-app/issues) for a full list of proposed features (and known issues).\n\n\n\n\n\u003c!-- LICENSE --\u003e\n## License\n\nSee [LICENSE](https://github.com/1111philo/apolis-app/blob/main/LICENSE).\n\n\u003cp align=\"right\"\u003e(\u003ca href=\"#readme-top\"\u003eback to top\u003c/a\u003e)\u003c/p\u003e\n\n\n\u003c!-- MARKDOWN LINKS --\u003e\n\u003c!-- https://www.markdownguide.org/basic-syntax/#reference-style-links --\u003e\n[contributors-shield]: https://img.shields.io/github/contributors/1111philo/apolis-app.svg?style=for-the-badge\n[contributors-url]: https://github.com/1111philo/apolis-app/graphs/contributors\n[stars-shield]: https://img.shields.io/github/stars/1111philo/apolis-app.svg?style=for-the-badge\n[stars-url]: https://github.com/1111philo/apolis-app/stargazers\n[issues-shield]: https://img.shields.io/github/issues/1111philo/apolis-app.svg?style=for-the-badge\n[issues-url]: https://github.com/1111philo/apolis-app/issues\n[license-shield]: https://img.shields.io/github/license/1111philo/apolis-app.svg?style=for-the-badge\n[license-url]: https://github.com/1111philo/apolis-app/blob/master/LICENSE.txt\n[product-screenshot]: images/screenshot.png\n\n[React.js]: https://img.shields.io/badge/React-20232A?style=for-the-badge\u0026logo=react\u0026logoColor=61DAFB\n[React-url]: https://reactjs.org/\n[React-bootstrap.com]: https://img.shields.io/badge/React-Bootstrap?style=for-the-badge\u0026logo=reactbootstrap\u0026color=%23712DF9\n[React-bootstrap-url]: https://react-bootstrap.github.io/\n[postgres-badge]: https://img.shields.io/badge/Postgres-%2523316192.svg?style=for-the-badge\u0026logo=postgresql\u0026logoColor=white\u0026color=%234169E1\n[postgres-url]: https://www.postgresql.org/\n[github-actions-badge]: https://img.shields.io/badge/GitHub_Actions-2088FF?style=for-the-badge\u0026logo=githubactions\u0026logoColor=white\u0026color=%232088FF\n[github-actions-url]: https://github.com/features/actions","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2F1111philo%2Fapolis-app","html_url":"https://awesome.ecosyste.ms/projects/github.com%2F1111philo%2Fapolis-app","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2F1111philo%2Fapolis-app/lists"}