Skip to content

1.0 - #42

Merged
ribborges merged 7 commits into
mainfrom
chore/1.0-api-freeze
Aug 12, 2026
Merged

1.0#42
ribborges merged 7 commits into
mainfrom
chore/1.0-api-freeze

Conversation

@ribborges

@ribborges ribborges commented Aug 12, 2026 •
edited
Loading

Copy link
Copy Markdown
Owner

Summary

This pull request prepares the Jaci UI library for its first stable 1.0.0 release. It freezes the public component API, updates documentation and examples to reflect the stable release process, improves test coverage and cross-browser support, and adds regression tests for key UI behaviors. The changes also clarify best practices for Next.js App Router integration with theming.

Stable release preparation and API freeze:

  • Added a Changeset marking the jaci-ui package as a major (1.0.0) release and froze the public component API for stability.
  • Renamed API contract and coverage files to 1.0.0 and updated their version fields. [1] [2]

Documentation updates:

  • Updated documentation throughout to describe the stable release process, and remove references to the experimental API freeze. (F5b3d6adL53R53, [1] [2] [3]
  • Improved and clarified component documentation and story descriptions, including translating examples to English for consistency. [1] [2] [3] [4] [5] [6]

Testing and CI improvements:

  • Enhanced browser test coverage by adding Firefox to Playwright and Vitest test matrix, updating CI workflow and scripts to support multiple browsers. [1] [2] [3] [4] [5]
  • Added a strict API contract coverage check to the CI workflow.

Regression and quality testing:

  • Added new Storybook stories for regression testing of theming, popup blur, dark mode elevation, and lightbox viewport behaviors.

Next.js App Router theming best practices:

  • Updated Next.js fixture and documentation to recommend placing ThemeProvider inside <body> and within a client boundary for correct SSR theming. [1] [2] [3] [4]

Validation

  • Formatting, linting, type checks and tests pass locally.
  • Storybook documents changed variants and states.
  • Accessibility and keyboard behavior were reviewed where relevant.
  • A Changeset was added for public package changes.
  • SSR and hydration behavior was checked when rendering or browser APIs changed.

@ribborges ribborges self-assigned this Aug 12, 2026
@ribborges
ribborges merged commit 2415276 into main Aug 12, 2026
8 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Reviewers

No reviews

Assignees

@ribborges ribborges

Labels

None yet

Projects

None yet

Milestone

No milestone

Development

Successfully merging this pull request may close these issues.

1 participant

@ribborges