Plumeria v4.0.2

2025/12/30

Changes

The css command has been removed from the @plumeria/compiler.
The compiler will be adapted to be used as a program, and may integrate with lightningcss and add packages such as a @plumeria/cli in the future.

The birth of postcss-plugin

@plumeria/compiler, new in v4.0.0, is used inside postcss-plugin as an extractor for static analysis. For Next.js, @plumeria/postcss-plugin is required to extract Plumeria at build time. refer Installation.

Core Changes

It no longer has @plumeria/core/stylesheet.css. This will cause the build to fail in all environments where @plumeria/core/stylesheet.css is imported.

entrypoint
import "@plumeria/core/stylesheet.css";

Instead extract all atomic styles to a CSS file with postcss-plugin for @plumeria maker:

css
@plumeria;

Your configuration should have a postcss.config.js like this:

postcss.config.js
module.exports = {
  plugins: {
    '@plumeria/postcss-plugin': {
      include: '**/*.{ts,tsx}',
      exclude: ['**/node_modules/**', '**/.next/**'],
    },
  },
};

Bugfix

Fixed a bug where css.keyframes would not compile if used in css.viewTransition.
This fix applies to the following bundler integration plugin packages:

  • webpack-plugin
  • turbopack-loader
  • vite-plugin

This indirectly fixes the behavior of next-plugin.


Feedback Discussion and bug Issues reports are welcome on GitHub !