jayjennings/open-safetylog-ehs

0 Fork 0

Files

T

jayjennings a382fa904a

CI / Lint, typecheck, test, build (push) Canceled after 0s

Details

CI / End-to-end tests (push) Canceled after 0s

Details

feat: initialize project structure with core components and pages

- Added shared styles for UI components in `src/components/styles.ts`.
- Created configuration constants in `src/lib/config.ts`.
- Implemented date formatting and greeting functions in `src/lib/dates.ts` and corresponding tests in `src/lib/dates.test.ts`.
- Developed incident management functions in `src/lib/incidents.ts` with tests in `src/lib/incidents.test.ts`.
- Established navigation structure in `src/lib/navigation.ts`.
- Seeded demo data for incidents and users in `src/lib/seed.ts`.
- Defined tone classes for UI elements in `src/lib/tones.ts`.
- Created type definitions for incidents and related entities in `src/lib/types.ts`.
- Set up main application entry point in `src/main.tsx`.
- Developed various pages including About, Analytics, Incidents, Locations, Overview, and Report Incident.
- Configured testing setup in `src/test/setup.ts` and TypeScript configurations.
- Integrated Vite for development and testing with appropriate plugins.

2026-10-06 10:07:57 -07:00

2.7 KiB

Raw Blame History

Contributing to Open SafetyLog EHS

Thanks for helping make workplace safety software free for everyone. Contributions of all kinds are welcome: bug reports, feature ideas, documentation, design, translations and code.

Everyone taking part is expected to follow our Code of Conduct.

Ways to contribute

Report a bug. Open an issue with steps to reproduce, what you expected, what happened, and your browser and device.
Suggest a feature. Open an issue describing the safety problem you're trying to solve, not only the solution. Real-world context from plants and safety teams is especially valuable.
Pick up work. Check the roadmap and to-do list. Comment on an issue before starting anything large so we can agree on the approach.

Development setup

Requires Node.js 22.12 or later (see .nvmrc).

npm install
npx playwright install chromium   # once, for end-to-end tests
npm run dev

Before opening a pull request, run:

npm run check      # lint, typecheck, unit tests, build
npm run test:e2e   # end-to-end tests on desktop and mobile

CI runs the same checks on every pull request.

Code guidelines

TypeScript everywhere; avoid any.
Structure: routes go in src/pages/, reusable UI in src/components/, and types and domain logic in src/lib/ (no React components there).
Styling: Tailwind CSS. Use the theme tokens in src/index.css (text-ink, bg-coral, border-line, …) rather than new hex values; add a token if a color is reused.
Tests: put domain logic in src/lib/ with a unit test next to it (*.test.ts). Cover user-facing flows with a component test or a Playwright test in e2e/.
Accessibility: every form control needs a label, and every icon-only button needs an aria-label. Shop-floor users may be on gloves-on touchscreens, so keep touch targets generous.
Safety data: incident and injury records can contain medical and personal information. Never log them, and never add third-party scripts, fonts or analytics that would send data off the server.

Commits and pull requests

Branch from main and keep each pull request focused on one change.
Use Conventional Commits messages, e.g. feat: add QR code location labels or fix: keep filter when returning to list.
Describe what changed and why, link related issues, and add screenshots for UI changes (desktop and mobile).
Update docs/ROADMAP.md or docs/TODO.md if your change completes or adds an item.

License

Open SafetyLog EHS is licensed under the GNU Affero General Public License v3.0. By submitting a contribution, you agree that it is licensed under the same terms.

2.7 KiB Raw Blame History