@beamcss/postcss

beamcss.dev — PostCSS plugin for Beam CSS. Works with webpack, Parcel, Next.js, and any PostCSS-based build pipeline.

Install

npm install beamcss @beamcss/postcss

Usage

// postcss.config.mjs
import beamcss from '@beamcss/postcss'

export default {
  plugins: [
    beamcss({
      config: './beam.config.ts',
      content: ['./src'],   // directory or file paths to scan — not globs
    }),
  ],
}

// postcss.config.cjs
module.exports = {
  plugins: [
    require('@beamcss/postcss')({
      config: './beam.config.ts',
      content: ['./src'],   // directory or file paths to scan — not globs
    }),
  ],
}

The plugin runs as a PostCSS Once plugin: it scans your source files for Beam class strings, compiles them to atomic CSS, and appends the result to the PostCSS root.

Options

| Option | Type | Default | Description | |---|---|---|---| | config | string | "beam.config.ts" | Path to your Beam config file | | content | string[] | ["."] | Directories or files to scan for class strings |

Note: content accepts directory paths and file paths, not glob patterns. Pass ['./src'] to scan your entire src folder recursively.

Peer dependency

postcss >= 8

Links

• beamcss.dev — full docs & syntax reference
• beamcss (core)
• GitHub
• License: MIT