# Getting started (for frontend developers)

# Introduction

Fireblog is an online blog writing interface whose content is accessible through its GraphQL API.

From the start, it was thought to allow to easily create static or Jamstack(opens new window) ultra-efficient blogs, by pairing it with technologies like Gatsby(opens new window) , Eleventy(opens new window) , Nuxt(opens new window) or Next(opens new window) . It also offers an interface made for long writing sessions for web editors and an intuitive and fun API for frontend developers.

The only limit to use the Fireblog API is your imagination, and we hope that you will build beautiful and surprising things with your favorite technologies and publish inspiring articles!

# Create your Fireblog account

First, create an account(opens new window) on Fireblog, then create your first blog.

Write one or many articles and PUBLISH THEM.

WARNING

For now, only the published articles are accessibles via the API.

# Explore the API

From now on, you can play with the API to get your blog content. Examples of GraphQL requests are available from the writing interface by clicking on the API button.

A modal opens and allows you to access the API explorer or to try one of the GraphQL request examples.

For example, by clicking on the Try it button of the request which gets the posts list, and then by clicking the button ▶️ in the API explorer, you can play with the GraphQL request and see your published posts list!

# Display your blog

You now have two solutions to display your blog:

# Use a starter theme

We have two open source starter themes, easily to customize, one uses Gatsby.js, and the other Eleventy.

Gatsby will suit those who like React, while Eleventy will please those who want a simple solution, without any client side JavaScript.

In the future, we will build a real theme catalog with nice designs and other front end technologies, so you can always find a front end that suits your project!

# Deploy and hosting

Nowadays, there are excellent hosting platforms to deploy your static and Jamstack sites, that can:

  • build your static site
  • deploy your static files on a CDN
  • if needed, redeploy a build of your site with a webhook

When the blog content changes, Fireblog can send a HTTP POST request to your hosting platform to declare that your blog needs to be built and deployed again.

At Fireblog, we recommend to use these hosting platforms for your static blogs:

# Configure webhooks

In the Fireblog interface, go to the blog settings.

In the webhooks form, you can fill in the URL that Fireblog must call to trigger the rebuild of your static blog. In the case below, it is a blog hosted by Netlify.

If needed, you can fill in many URL, comma separated.