JustFix Component Library

Component library for JustFix's design system.

Based this repo on this course (local copy of course mateirals in our drive)

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.

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