# Getting started (for frontend developers)
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 ultra-efficient blogs, by pairing it with technologies like Gatsby, Eleventy, Nuxt or Next. 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 on Fireblog, then create your first blog.
Write one or many articles and PUBLISH THEM.
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 one of our starter themes (fastest way).
- Create your own front end and query the GraphQL API to get your blog content, and so use the technology of your choice. You can find examples here: https://github.com/fireblogcms/fireblog-examples
# Use a starter theme
We have two open source starter themes, easily to customize, one uses Gatsby.js, and the other Eleventy.
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:
- Netlify: they are behind the Jamstack concept!
- Vercel: by the Next.js creators, it is a powerful deploying platform for your static, serverless or dynamic web applications.
# 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.