CrowdCAD

CrowdCAD is an open-source, browser-based Computer-Aided Dispatch (CAD) system for volunteer EMS and event medical teams. Full developer and operational documentation lives in the docs/ folder and in policy files. The demo with further information can be found at crowdcad.org

Quick links

• User guide: docs/USER_GUIDE.md
• Architecture: docs/ARCHITECTURE.md
• Component patterns: docs/COMPONENTS.md
• Firebase & setup: docs/FIREBASE_SETUP.md
• Self-hosting: docs/DEPLOYMENT.md
• Contributing guide: CONTRIBUTING.md
• Code of Conduct: CODE_OF_CONDUCT.md
• Changelog / Releases: CHANGELOG.md
• Security & reporting: SECURITY.md
• License: LICENSE.md

Quickstart

1. Fork then clone (recommended — preserves attribution and lets you receive upstream updates):

# Fork via GitHub first: https://github.com/evanqua/crowdcad
# Then clone your fork:
git clone https://github.com/<your-github-username>/crowdcad.git
cd crowdcad
npm install
npm run dev

Or clone directly without forking:

git clone https://github.com/evanqua/crowdcad.git
cd crowdcad
npm install
npm run dev

2. The dev server runs at http://localhost:3000.

3. For Firebase configuration, follow the instructions in docs/FIREBASE_SETUP.md. The runtime initializer is at src/app/firebase.ts.

Environment example

Copy .env.example to .env.local and fill your Firebase values before running locally. Do not commit your .env.local:

cp .env.example .env.local
# edit .env.local and paste values from your Firebase project settings

When to read the other docs

• Read docs/ARCHITECTURE.md before making cross-cutting changes.
• Read docs/COMPONENTS.md before adding UI components or modals.
• Follow docs/DEPLOYMENT.md and docs/FIREBASE_SETUP.md for self-hosting and compliance guidance (BAA, rules, backups).
• See docs/USER_GUIDE.md for operator-facing workflows and screenshots.

Reporting and policies

• Report security issues per SECURITY.md.
• Community expectations are in CODE_OF_CONDUCT.md.

Contributing

Please consult CONTRIBUTING.md for workflow and PR guidance. For small changes, open a branch, push and create a PR for review.

Community & visibility

CrowdCAD's mission is to make volunteer event medical services safer and more effective. To help the project reach as many organizations as possible:

• Please fork the repository on GitHub when adopting or modifying CrowdCAD. Forks preserve attribution and make upstream collaboration visible.
• Star and watch the repo if you use it; forks, stars and PRs are public signals that help discoverability.
• If you use CrowdCAD for your organization, consider linking back to this repository in your README or site to help others find the project.

Support / Contact

For questions, security reports, or hosting inquiries, email: support@crowdcad.org

Acknowledgements

CrowdCAD is built by volunteers and maintainers listed in the project metadata. See the individual docs for maintainers and contact details.

CrowdCAD is an open-source software framework. It does not provide HIPAA compliance out of the box. Organizations hosting CrowdCAD are solely responsible for ensuring their implementation meets applicable legal and regulatory requirements, including HIPAA.

CrowdCAD contributors assume no responsibility for how this software is used.