Flotiq blog

by flotiq

GitHub Readme.md

Flotiq logo

Flotiq Blog

This is a Gatsby starter project for a blog with tags and authors. It's configured to pull recipe data from Flotiq and can be easily deployed to your cloud hosting - Heroku, Netlify, Gatsby Cloud, etc.

See it live on Flotiq/Blog

Screenshot

Flotiq Blog Image

Quick start

  1. Start project from template using Gatsby CLI

    gatsby new flotiq-blog https://github.com/flotiq/flotiq-blog.git
  2. Setup "flotiqBlogTag", "flotiqBlogAuthor", and "flotiqBlogPost" Content Type in Flotiq

    Create your Flotiq.com account.

    Next, create necessary Content Types:

    Tag content type in flotiq Author content type in flotiq Post content type in flotiq

    Note: You can also create necessary types using Flotiq REST API.

  3. Configure application

    The next step is to configure our application to know from where it has to fetch the data.

    You need to create a file called .env inside the root of the directory, with the following structure:

    GATSBY_FLOTIQ_BASE_URL=https://api.flotiq.com
    GATSBY_FLOTIQ_API_KEY=YOUR FLOTIQ API KEY
    
  4. Start developing

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

    cd flotiq-blog
    npm install
    gatsby develop

    If you wish to import example posts, tags and authors to your account, before running gatsby develop run:

    node ./.flotiq/importExample.js

    It will add 4 images, 1 tag, 1 author and 3 posts to your Flotiq account.

    Note: You need to put your Read and write API key in .env for import to work. You don't need any content types in your account. If you already have tag with ids flotiqBlogTag-1, author with flotiqBlogAuthor-1 or posts with ids flotiqBlogPost-1, flotiqBlogPost-2 and flotiqBlogPost-3 they will be overwritten.

  5. Open the source code and start editing!

    Your site is now running at http://localhost:8000!

    Note: You'll also see a second link: http://localhost:8000/___graphql`. This is a tool you can use to experiment with querying your data. Learn more about using this tool in the Gatsby tutorial.

    Open a project directory in your code editor of choice and edit src/templates/index.js. Save your changes, and the browser will update in real time!

  6. Manage your recipes using Flotiq editor

    You can now easily manage your recipes using Flotiq editor

    Managing recipes using Flotiq

Deploy

You can deploy this project to Heroku in 3 minutes:

Deploy

Or to Netlify:

Deploy

Collaborating

If you wish to talk with us about this project, feel free to hop on our discord server.

If you found a bug, please report it in issues.