JustFix Component Library

Component library for JustFix's design system.

Local development setup

1. install npm locally if it doesn't already exist brew install npm
2. npx sb init

• builder error: select Webpack 5
• dependency resolution errors: npm install --legacy-peer-deps

3. npm run storybook
4. if there are OSSL issues, run export NODE_OPTIONS=--openssl-legacy-provider

Publishing the package

This package is published to the npm registry. Pushing a version tag triggers GitHub Actions to lint, test, build, publish to npm, and deploy Storybook.

Before publishing: update CHANGELOG.md (move [Unreleased] entries to the new version). Semver guidance: design-system/VERSIONING.md.

One-time setup (org admin): configure trusted publishing on the npm package settings page. Select GitHub Actions and set:

• Organization / user: JustFixNYC
• Repository: component-library
• Workflow filename: publish.yml

CI authenticates via OIDC — no NPM_TOKEN secret is required for publish.

npm run lint
npm version [major|minor|patch]   # creates git tag vX.Y.Z
git push --follow-tags            # triggers CI publish