babel-plugin-transform-goober

A Babel plugin for 🥜goober, rewriting styled.div syntax to styled('div') calls.

Install

npm install --save babel-plugin-transform-goober

How to use

Edit .babelrc.json

{
  "presets": [...],
  "plugins": ["babel-plugin-transform-goober"]
}

And now you can create your components using styled.* syntax:

import React from 'react';
import { styled } from 'goober';

const Button = styled.button`
    margin: 0;
    padding: 1rem;
    font-size: 1rem;
    background-color: tomato;
`;

If you want to use some other identifier than styled you need to tell the plugin about it. Set the configuration option "name" to the identifier name that want to use. For example, a .babelrc.json file like this:

{
  "presets": [...],
  "plugins": [["babel-plugin-transform-goober", { "name" : "goober" }]]
}

allows you to use goober like this:

import React from 'react';
import { styled as goober } from 'goober';

const Button = goober.button`...`;

Better Debugging Experience

Setting the displayName option to true, will add richer component names and additional CSS classes to the component. This makes it easier to find your components in the devtools or in your HTML.

{
  "presets": [...],
  "plugins": [["babel-plugin-transform-goober", { "displayName" : true }]]
}

Example output:

// with displayName: false
<button className="go1231232"></button>
// with displayName: true
<button className="Sidebar__Button-go-1 go1231232"></button>

Dead Code Elimination

Minifiers have a hard time proving that a styled() call has no side-effects and therefore won't remove them. By default this plugin will automatically insert #__PURE__ annotations to mark these functions as pure. You can opt out of this feature at the cost of bigger bundles by passing pure: false.

{
  "presets": [...],
  "plugins": [["babel-plugin-transform-goober", { "pure" : false }]]
}