Gatsby Starter Blockstack

Gatsby Starter Blockstack is a boilerplate Gatsby project that wires up Blockstack's decentralized identity and storage into a Gatsby site, giving you a starting point for building decentralized apps and a reference implementation for how the two technologies fit together.

What is Gatsby Starter Blockstack?

Gatsby Starter Blockstack is a GitHub repository and Gatsby starter that combines the Gatsby static-site framework with Blockstack's decentralized app platform. It is a fork of the jamstack-hackathon-starter and is published as a template you can clone, customize, and deploy. The starter's output is a working Gatsby site that includes Blockstack integration code, and its maintainer (friedger) positions it as the place to begin for your next Blockstack idea.

Key Features

• One-click Netlify deployment — The repository links to a Netlify deploy button that clones and deploys the starter immediately via a GitHub URL.
• Gatsby framework — Built on Gatsby, so the site is a static React site with Gatsby's build tooling and asset optimization out of the box.
• Blockstack integration — Demonstrates how to use Blockstack in a Gatsby context, acting as a reference implementation for decentralized app development.
• Fork from jamstack-hackathon-starter — Inherits the structure of a JAMstack hackathon starter, which typically includes an app directory and a src layout for components and pages.
• Nested documentation — Includes separate README files under src and src/app that explain the layout and the app-specific code.
• gatsby start support — Can be initialized as a new project using the gatsby start CLI command against the Git URL.

Who is it for?

• Gatsby developers exploring Blockstack — Use this starter to see how Blockstack can be integrated into a Gatsby build without starting from scratch.
• Hackathon participants — Because it's a fork of a hackathon starter, it's suited for quickly scaffolding a working project with auth and data storage during a weekend event.
• Developers building decentralized apps — Use the reference implementation to understand the pattern, then replace the sample code with your own app logic.

What can you do with Gatsby Starter Blockstack?

• Quickly scaffold a decentralized app: Clone the repo and use the Netlify deploy button to spin up a deployable site with a working Blockstack integration.
• Study a working example: Read the nested READMEs and source code to learn how Blockstack calls are structured inside a Gatsby project.
• Extend into a full application: Add your own React components and Gatsby pages on top of the starter's Blockstack integration, using the existing structure as a base.

How does Gatsby Starter Blockstack work?

The starter is a Gatsby project that you clone or initialize via gatsby start. After setup, you can run Gatsby's local dev server to see the site, then deploy to a static host like Netlify using the provided one-click button or your own build pipeline. The nested src README and src/app README document how the component layout and the Blockstack-related app code are organized.

FAQ

Is Gatsby Starter Blockstack free?

Yes, it is an open-source GitHub repository, and the starter can be cloned and deployed without any licensing fee.

How do I deploy Gatsby Starter Blockstack?

The quickest path is the Netlify deploy button on the project page, which clones and deploys the repository to Netlify with one click. You can also clone the repo and push it to your own host.

Does the starter include Blockstack documentation?

It includes nested README files that explain the layout and the app code, and the project links to docs.blockstack.org as an additional resource.

What is the relationship to jamstack-hackathon-starter?

Gatsby Starter Blockstack is a fork of the jamstack-hackathon-starter, so it shares that starter's project structure while adding a Blockstack integration.

What does the repository's metadata say?

The repository description is 'Make decentralized apps with Gatsby + Blockstack', and it currently has 5 stars on GitHub.