0.1.5 • Published 4 months ago

grapesjs-tailwindcss-plugin v0.1.5

Weekly downloads
-
License
MIT
Repository
github
Last release
4 months ago

GrapesJS TailwindCSS Plugin

The GrapesJS TailwindCSS Plugin seamlessly integrates Tailwind CSS 4 with GrapesJS, enabling you to leverage a modern CSS framework directly within your page builder. With on-the-fly CSS building, this plugin provides up-to-date styles and exports the compiled CSS with your project.

Key Features:

  • Tailwind CSS 4 Integration: Utilize the latest version of Tailwind CSS.
  • Dynamic CSS Build: Automatically compiles Tailwind CSS based on your project's classes.
  • Export Ready: The compiled CSS is appended to your export, ensuring consistency.
  • Multi Page Support: The plugin makes use of the PageManager

DEMO

Installation

CDN

<script src="https://unpkg.com/grapesjs-tailwindcss-plugin"></script>

NPM

npm i grapesjs-tailwindcss-plugin

GIT

git clone https://github.com/fasenderos/grapesjs-tailwindcss-plugin.git

Usage

Directly in the Browser

<link
  href="https://unpkg.com/grapesjs/dist/css/grapes.min.css"
  rel="stylesheet"
/>
<script src="https://unpkg.com/grapesjs"></script>
<script src="path/to/grapesjs-tailwindcss-plugin.min.js"></script>

<div id="gjs"></div>

<script type="text/javascript">
  var editor = grapesjs.init({
    container: "#gjs",
    // ... other configurations
    plugins: ["grapesjs-tailwindcss-plugin"],
    pluginsOpts: {
      "grapesjs-tailwindcss-plugin": {
        // Options like autobuild, toolbarPanel, notificationCallback, buildButton, etc.
      },
    },
  });
</script>

Modern Javascript

import grapesjs from "grapesjs";
import plugin from "grapesjs-tailwindcss-plugin";
import "grapesjs/dist/css/grapes.min.css";

const editor = grapesjs.init({
  container: "#gjs",
  // ... other configurations
  plugins: [plugin],
  pluginsOpts: {
    [plugin]: {
      // Options like autobuild, toolbarPanel, notificationCallback, buildButton, etc.
    },
  },
  // Alternatively:
  // plugins: [
  //   editor => plugin(editor, { /* options */ }),
  // ],
});

Summary

  • Plugin name: grapesjs-tailwindcss-plugin
  • Commands: build-tailwind
  • Button: build-tailwind-button

Options

OptionDescriptionDefault
prefixPrefix to use for Tailwind CSS classes. Helps differentiate Tailwind classes from others.tw
autobuildIf true, the plugin automatically rebuilds Tailwind CSS on each update. Set to false for manual builds.true
customCssA custom css that will be appended immediately after the @import 'tailwindcss'; statement. See the tailwind docs for more info.""
buildButtonOption to add a manual build button to the toolbar for triggering the CSS build process.false
toolbarPanelSpecify the panel where the build button should be added (e.g., options).options
notificationCallbackA custom callback function to handle notifications when Tailwind CSS is compiled.() => void

Development

Clone the repository

$ git clone https://github.com/fasenderos/grapesjs-tailwindcss-plugin.git
$ cd grapesjs-tailwindcss-plugin

Install dependencies

$ npm i

Start the dev server

$ npm start

Build the source

$ npm run build

License

Copyright Andrea Fassina, Licensed under MIT.

0.1.5

4 months ago

0.1.4

4 months ago

0.1.3

4 months ago

0.1.2

4 months ago

0.1.1

4 months ago

0.1.0

4 months ago

0.0.1

4 months ago