Builder.io Gatsby Starter

Gatsby starter with drag + drop page building with your React components via Builder.io's visual headless CMS

Quick Start

1. Sign up at Builder.io and Create a Gatsby site.

   • Clone this repository or use gatsby new

   # create a new Gatsby site using this starter
   gatsby new my-builder-site https://github.com/BuilderIO/gatsby-starter-builder
   

   • Grab a free account at builder.io and create a new space. Then return to this page and follow this link to get set up with all the models used in this starter and some sample content to get you started.

   • In Builder.io, click on the Account icon on the left sidenav.

   

   • Change the Site URL to http://localhost:8000 and copy the Public API Key.

   • In your code editor, add the Public API Key you just copied to src/config.js

   builderAPIKey: '59bb518773c14842921abe05d5e2bee3' <-- replace this with your API Key
   

2. Start developing.

   Navigate into your new site’s directory and start it up.

   cd my-default-starter/
   gatsby develop
   

   Then start building pages in Builder! Use the pre-built templates, and components to create exactly what you want. This starter uses @builder.io/gatsby plugin to fetch all your published pages and add them to your Gatsby build.

3. Deploy.

For continuous deployment from netlify <> Builder.io :

• Create a build hook in netlify
• Add the build hook from last step to Builder.io global webhooks in your new space settings.

🧐 What's inside?

This starter demonstrates creating dynamic pages in Builder.io on new URLs and generating them with Gatsby, as well as rendering specific parts of your site with Builder.io content via GraphQL queries (e.g. for pages, header, footer, etc)

See:

• src/templates/LandingPage.jsx for using GraphQL to query and render Builder.io components and pages manually in parts of your Gatsby site and content
• src/layouts/PageLayout.jsx for an example on wrapping your pages with conent from header and footer model entries.
• @builder.io/gatsby the plugin used in this starter to generate pages dynamically.

Using your custom components in the editor

👉Tip: want to limit page building to only your components? Try components only mode

Register a component

import { Builder } from '@builder.io/react';

class SimpleText extends React.Component {
  render() {
    return <h1>{this.props.text}</h1>;
  }
}

Builder.registerComponent(SimpleText, {
  name: 'Simple Text',
  inputs: [{ name: 'text', type: 'string' }]
});

Then import it in the template or in your builder-settings.js

import './components/simple-text';
// ...

See:

• src/components/Hero/hero.builder.js for an example of using a custom react component in the Builder.io visiaul editor.

• design systems example for lots of examples using your deisgn system + custom components

Mixed Content errors when hosting on insecure http

Our editor uses the preview URL you supply for live editing. Because the editor is on https, the preview might not work correctly if your development setup uses http. To fix this, change your development set up to serve using https. Or, as a workaround, on Chrome you can allow insecure content on localhost, by toggling the insecure content option here chrome://settings/content/siteDetails?site=http%3A%2F%2Flocalhost%3A9009

Prerequisites

• Node
• Gatsby CLI

Available scripts

build

Build the static files into the public folder

Usage

$ npm run build

clean

Runs gatsby clean command.

Usage

npm run clean

develop or start

Runs the clean script and starts the gatsby develop server using the command gatsby develop.

Usage

npm run develop

format

Formats code and docs according to our style guidelines using prettier

Usage

npm run format

CONTRIBUTING

Contributions are always welcome, no matter how large or small.

Learn more

• Official docs

Gatsby starters and resources: