Skip to content

components-ai/css.gui

 
 

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

115 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

CSS GUI

Visual development environment for CSS.

CSS GUI is a visual toolkit for editing element styles on the web. It's theme-aware, performant, and can be composed into any React app.

Why?

We want to improve creative coding and web development workflows by making it simpler to attach parametric controls that are designed specifically to work with CSS.

With CSS GUI, folks can visually edit and generate CSS. They can install the controls and use locally in their own projects or use our hosted version.

Eventually, these controls can also augment development environments like VS Code.

Supporting the full CSS spec

These controls are specifically built for CSS and will adhere to the CSS spec. This builds on the web platform itself, allowing the expressiveness of CSS/HTML/SVG to create endless outputs.

It's our goal and intention to support the entire CSS spec beginning with the more common controls like Length, Color, Keywords and expanding over time to more complex stacks and grammars (think gradients, background-image, box shadow, etc.).

⚠️ CSS GUI is currently under active development (contributions are welcome)

Please bear with us as the API stabilizes and more (missing) functionality is added. We welcome any and all contributions and would love it if you try to experiment with CSS GUI and report bugs or open up feature requests.

Installation

npm install --save css-gui

Usage

import { useState } from 'react'
import { Editor, RenderElement } from 'css-gui'

export const MyEditor = () => {
  const [styles, setStyles] = useState({})

  return (
    <>
      <Editor value={styles} onChange={setStyles} />
      <RenderElement tagName="p" styles={styles}>
        Hello, world!
      </RenderElement>
    </>
  )
}

Read the full getting started guide →

Development

Installation

git clone https://github.com/components-ai/css-gui
cd css-gui
yarn

Running the development server

yarn dev
open http://localhost:3001

Running the tests

yarn test

Reinstalling dependencies and clearing caches

On rare ocassions, especially when changing configurations, you might need to clear the cache and reinstall the dependencies:

yarn nuke

Resources

Inspiration

  • dat.gui well known, especially in the generative design/three space
  • leva a React-based pmndrs project that builds the entire control set from hooks
  • Blender - Shader and Geometry nodes allow for rapid exploration withiin the available rendering space
  • MDN Docs have long been an amazing introduction to how various CSS property values will affect the appearance of a DOM element.

Packages

 
 
 

Contributors

Languages