{"id":25013870,"url":"https://github.com/code4recovery/oiaa-direct","last_synced_at":"2026-04-01T23:55:24.400Z","repository":{"id":228982734,"uuid":"759921220","full_name":"code4recovery/oiaa-direct","owner":"code4recovery","description":"Version of OIAA's Online Meeting List that queries meeting data directly from the database.","archived":false,"fork":false,"pushed_at":"2025-03-23T08:59:31.000Z","size":2002,"stargazers_count":0,"open_issues_count":4,"forks_count":0,"subscribers_count":3,"default_branch":"main","last_synced_at":"2025-03-23T09:34:58.202Z","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/code4recovery.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,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2024-02-19T15:38:01.000Z","updated_at":"2025-03-04T00:25:41.000Z","dependencies_parsed_at":"2024-03-31T22:25:36.206Z","dependency_job_id":"fe77112a-de4b-4783-b119-142276013d52","html_url":"https://github.com/code4recovery/oiaa-direct","commit_stats":null,"previous_names":["code4recovery/oiaa-direct"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/code4recovery%2Foiaa-direct","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/code4recovery%2Foiaa-direct/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/code4recovery%2Foiaa-direct/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/code4recovery%2Foiaa-direct/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/code4recovery","download_url":"https://codeload.github.com/code4recovery/oiaa-direct/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":246277367,"owners_count":20751549,"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":"2025-02-05T07:16:35.339Z","updated_at":"2026-04-01T23:55:24.382Z","avatar_url":"https://github.com/code4recovery.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# OIAA Direct (oiaa-direct)\n\nVersion of OIAA's Online Meeting List that queries meeting data from the data source through `central-query`.\n\n---\n\n## Project Overview\n\nOIAA Direct is a React + TypeScript + Vite application for browsing and searching online meetings. It fetches meeting data from a central-query API and provides filtering, search, and group information features.\n\n---\n\n## Quick Start\n\n```bash\ngit clone https://github.com/your-org/oiaa-direct.git\ncd oiaa-direct\nnpm install\nConfigure `.env`\nnpm run dev\n```\n\n---\n\n## Setup\n\n1. Clone the repo to a folder of your choice.\n2. Run `npm install` from that folder.\n3. Update `.env` environment variables as needed.\n\n### Required Environment Variable\n\n```env\nVITE_CQ_URL=\"https://central-query.apps.code4recovery.org/api/v1/meetings\"\n```\n\n---\n\n## Recommended VS Code Extensions\n\n- [Prettier - Code formatter](https://marketplace.visualstudio.com/items?itemName=esbenp.prettier-vscode)\n- [ESLint](https://marketplace.visualstudio.com/items?itemName=dbaeumer.vscode-eslint)\n- [JS/TS Import/Export Sorter](https://marketplace.visualstudio.com/items?itemName=amatiasq.sort-imports)\n\nThe repo includes config files for each of these plugins.\n\n---\n\n## React Router\n\nThis project relies heavily on the [React Router](https://reactrouter.com/) framework (currently **version 7.x**).\n\n- **Route Types:**  \n  Always use the types and utilities provided by React Router v7 for generating and maintaining route types.  \n  Avoid hardcoding route paths or types—leverage the framework’s helpers and conventions for consistency and type safety.\n\n- **Upgrading:**  \n  If upgrading React Router, review the [migration guides](https://reactrouter.com/en/main/upgrading/v6) and update route types, navigation, and related logic accordingly.\n\nRefer to the [official React Router documentation](https://reactrouter.com/en/main) for version-specific APIs and best practices.\n\n---\n\n---\n\n## Folder Structure\n\n```bash\nsrc/\n  components/      # React components\n  utils/           # Utility functions\n  meetingTypes.ts  # TypeScript types\n  getData.ts       # Data fetching logic\npublic/\n.env\npackage.json\n```\n\n---\n\n## WordPress Plugin\n\nOIAA Direct includes a WordPress plugin that loads the app via CDN using the `[oiaa_meetings]` shortcode. See **[WORDPRESS.md](WORDPRESS.md)** for full documentation — installation, settings, updating, troubleshooting, and developer build/release workflow.\n\n---\n\n## Testing\n\nTo run tests (if available):\n\n```bash\nnpm test\n```\n\n---\n\n## Contributions\n\nPlease follow the [Udacity Guide](https://udacity.github.io/git-styleguide/) for commit messages.  \nIf committing code for a feature that is not complete, add `(wip)` to the title.  \nExample: `feat: (wip) Add React Router to fetch meeting data.`\n\n---\n\n## React + TypeScript + Vite\n\nThis template provides a minimal setup to get React working in Vite with HMR and some ESLint rules.\n\nCurrently, two official plugins are available:\n\n- [@vitejs/plugin-react](https://github.com/vitejs/vite-plugin-react/blob/main/packages/plugin-react/README.md) uses [Babel](https://babeljs.io/) for Fast Refresh\n- [@vitejs/plugin-react-swc](https://github.com/vitejs/vite-plugin-react-swc) uses [SWC](https://swc.rs/) for Fast Refresh\n\n## License\n\n[MIT](LICENSE)\n\n---\n\n## Support\n\nFor questions or support, please open an issue or contact the maintainers.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcode4recovery%2Foiaa-direct","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fcode4recovery%2Foiaa-direct","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcode4recovery%2Foiaa-direct/lists"}