← Back to all posts

By Rox Team

Rox v2026.4.0 Released

Rox v2026.4.0 has been released! πŸŽ‰

In this major release, we've upgraded our core build tool to Vite 8.

Vite 8 adopts the new Rust-based "Rolldown" as its internal bundler, providing a massive boost in build speeds compared to the traditional Rollup. Furthermore, with support for the highly flexible "Environment API," our frontend build environment has become much more refined.

Coupled with the introduction of vite-plusβ€”an extended, powerful Vite toolchainβ€”our developer experience (DX) has greatly improved by seamlessly integrating code formatting and linting. This foundational overhaul not only brings significant performance enhancements but also secures a very robust environment ready for the continuous evolution of the frontend ecosystem.

Version Information

Component Version
Rox (Project) 2026.4.0
Hono Rox (Backend) 1.5.0
Waku Rox (Frontend) 1.5.0
Shared 1.5.0

⚠️ Important Changes & Mandatory Deployment Steps

This update contains important environmental changes and mandatory steps for deployment. Please review these carefully before updating.

1. Database Migration (Mandatory)

Must be executed before deployment. This version introduces changes to the database schema. Deploying without running the migration will cause features like the notification API to fail.

bun run db:migrate

2. Node.js Version Requirements

With the introduction of Vite 8, the required Node.js version has been raised. Node.js 20.19+ or 22.12+ is now required. Please verify your Node.js version on the deployment environment before proceeding.

3. npm Scripts Changes

Commands for Linting and Formatting have been updated. If you use these in your CI/CD pipelines or local development scripts, please update them:

  • oxlint β†’ vp lint
  • oxfmt β†’ vp fmt

4. Clean Installation of Dependencies

Because the structure of bun.lock has significantly changed, we highly recommend deleting node_modules and performing a clean installation when upgrading an existing environment:

rm -rf node_modules packages/*/node_modules
bun install

CI/CD and Build-related Changes

5. vite-plus Binaries

The vite-plus package now provides the vp, oxlint, and oxfmt binaries. If you were individually installing oxlint or oxfmt in your CI previously, that step is no longer necessary.

6. Build Artifact Hash Changes

While the build command (bun run build) itself remains unchanged, the underlying usage of Vite 8 (Rolldown) means all generated file hashes will change. If you are using CDN caching, a cache purge might be necessary.

7. Waku Peer Dependency Warnings

Due to differences between the Vite version declared by the framework (Waku) and the actual environment (forced override to Vite 8), you will see peer dependency mismatch warnings during bun install. This does not affect functionality, and you can safely ignore it.

🎨 8. Introducing Storybook 10 (Frontend)

To enhance the frontend development environment, we've integrated Storybook 10 and added a catalog (Stories) for over 16 core UI components. This makes independent UI verification and development testing for components much easier.

To start Storybook locally, run the following command:

bun run storybook

Alternatively: bun run --cwd packages/frontend storybook

πŸ› Bug Fixes & Other Improvements

In addition to the build tool overhaul, this release includes the following UX improvements and bug fixes.

  • πŸ› Fix for Hydration Error on Nested SpaLinks: Fixed a React Hydration error that occurred inside the Sidebar component.
  • πŸ› Fundamental SPA Navigation Rewrite: Fixed the root cause of issues where content failed to update upon using the browser's "Back" button (e.g., on user profiles). We have completely removed the history.pushState monkey-patch and flushSync usage, replacing them with a highly stable navigation-tracking system using standard Waku routing alongside custom rox-navigation events.
  • πŸ› Automated Tag Fixes: Improved the CI flow to use the GitHub API for resolving correct usernames when generating mentions in automated release notes.
  • 🎨 Icon Replacements: Replaced the Github icon from lucide-react (which was removed in a package update) with rendering via an inline SVG.

What's Next for Rox

By keeping up with the rapidly evolving ecosystem and upgrading our foundation to the latest tech stack (Vite 8), Rox is now equipped to provide a more comfortable and stable operating environment.

If you have any questions or feedback, please contact us via our GitHub Repository.

Love Rocks. Rox. πŸš€