Flotiq Gatsby Event 1

Overview

The Gatsby starter for events with Flotiq source is a boilerplate template that allows you to kickstart your event project. It comes with the main Gatsby configuration files needed to quickly set up a React app. The project uses Flotiq, a headless CMS for storing data, as well as Tailwind CSS framework for styling. It also includes Flotiq source plugin and Flotiq components for React to fetch and display data from Flotiq in a visually appealing way. This project is compatible with node version 18.0.0 and above, as it requires Gatsby 5.

Features

• Boilerplate template for events project
• Uses Flotiq as a headless CMS to store data
• Integrates Tailwind CSS framework for easy and efficient styling
• Includes Flotiq source plugin to fetch data from Flotiq
• Utilizes Flotiq components for React to display data beautifully

Installation

To start the project from the template using Flotiq CLI:

1. Open the terminal and navigate to the desired project path.
2. Run the following command:

   npx flotiq-cli gatsby-starter-events projectName flotiqApiKey
   

   • Replace projectName with the desired name for your project. Use . if you want to start the project in the current directory.
   • Replace flotiqApiKey with your Read and Write API key for your Flotiq account.

This command will create the project based on the template using the gatsby new command, install npm dependencies, set up variables in the .env file, and import example data into your Flotiq account using the flotiq import command. Finally, it will start the development server using the gatsby develop command.

Note: If you used the Flotiq CLI to start the project, the step for importing example data is optional.

To configure environment variables:

1. Inside the root directory of your project, create a file named .env.development.
2. In the .env.development file, set the following structure:

   flotiqApiKey=yourFlotiqApiKey
   

To import example data (optional):

If you want to import example data into your Flotiq account, follow these steps:

1. Before running gatsby develop, run the following command:

   flotiq local-import <path-to-json-file> --apiKey <yourFlotiqApiKey>
   

   • Replace <path-to-json-file> with the path to the JSON file containing the example data.
   • Replace <yourFlotiqApiKey> with your Read and Write API key for your Flotiq account.

   This command will add four example objects to your Flotiq account.

Development:

1. Navigate to your project’s directory in the terminal.
2. Start the project by running the following command:

   gatsby develop
   

3. Your site will now be running at http://localhost:8000.
4. To experiment with querying your data, you can also use the GraphQL tool at http://localhost:8000/___graphql.

Summary

The Gatsby starter for events with Flotiq source is a convenient boilerplate template for kickstarting event projects. It includes integration with Flotiq as a headless CMS for managing data, as well as Tailwind CSS framework for easy styling. The template comes with Flotiq source plugin and Flotiq components for React to fetch and display data from Flotiq in a visually appealing way. The installation process involves setting up environment variables, importing example data (optional), and starting the development server. Overall, this starter template provides a solid foundation for creating event-based websites or applications.