@hover/gatsby-plugin
Advanced tools
To use Blueprint in your Gatsby site, you need to install the plugin and its peer dependencies.
npm i @hover/gatsby-plugin @hover/blueprint @emotion/react @emotion/styled framer-motion
# or
yarn add @hover/gatsby-plugin @hover/blueprint @emotion/react @emotion/styled framer-motion
@hover/gatsby-plugin as a plugin in your Gatsby config.// gatsby-config.js
module.exports = {
plugins: ["@hover/gatsby-plugin"],
}
// src/pages/index.js
import React from "react"
import { Box, Body } from "@hover/blueprint"
function IndexPage() {
return (
<Box padding={600}>
<Body size={500}>Hello World</Text>
</Box>
)
}
export default IndexPage
By default, this plugin adds the main context provider (BlueprintProvider) to make all components work correctly. Any options specified in the plugin configuration will be passed to the BlueprintProvider.
<BlueprintProvider resetCSS={resetCSS} portalZIndex={portalZIndex}>
{element}
</BlueprintProvider>
You can disable either of these with Gatsby options:
// gatsby-config.js
module.exports = {
plugins: [
{
resolve: "@hover/gatsby-plugin",
options: {
/**
* @property {boolean} [resetCSS=false]
* if `false`, this plugin will not use `<CSSReset />
*/
resetCSS: true,
/**
* @property {number} [portalZIndex=40]
* The z-index to apply to all portal nodes. This is useful
* if your app uses a lot z-index to position elements.
*/
portalZIndex: 40,
},
},
],
}
⚠️ Note: this should only be necessary for augmenting or adding components that Blueprint does not support. Any necessary customizations should be discussed with the design systems team so we can consider incorporating them upstream in @hover/chakra-theme.
To use customize the theme in your Gatsby site, you can shadow the plugin's
src/@hover/gatsby-plugin/theme.js file with your own theme:
// src/@hover/gatsby-plugin/theme.js
import { extendTheme } from "@hover/blueprint"
const theme = {
colors: {
primary: "rebeccapurple",
},
}
export default extendTheme(theme)
You can learn more about custom theme at Chakra UI's documentation.
FAQs
Drop-in Blueprint support for Gatsby sites
We found that @hover/gatsby-plugin demonstrated a not healthy version release cadence and project activity because the last version was released a year ago. It has 16 open source maintainers collaborating on the project.
Did you know?
Socket for GitHub automatically highlights issues in each pull request and monitors the health of all your open source dependencies. Discover the contents of your packages and block harmful activity before you install or update your dependencies.
Company News
Socket won two 2026 Reppy Awards from RepVue, ranking in the top 5% of all sales orgs. AE Alexandra Lister shares what it's like to grow a sales career here.
Security News
NIST will stop enriching most CVEs under a new risk-based model, narrowing the NVD's scope as vulnerability submissions continue to surge.
Company News
/Security News
Socket is an initial recipient of OpenAI's Cybersecurity Grant Program, which commits $10M in API credits to defenders securing open source software.