Gatsby Starter - Event Calendar

We are retiring this starter, please use https://github.com/flotiq/flotiq-gatsby-event-1 and https://github.com/flotiq/flotiq-gatsby-event-2

This is a Gatsby starter project for a event calendar. It's configured to pull events data from Flotiq and can be easily deployed to your cloud hosting - Heroku, Netlify, Gatsby Cloud, etc.

Live Demo: https://flotiq-starter-for-events-cal.herokuapp.com/

Screenshot

Quick start

1. Start the project from template using Flotiq CLI

   npm install -g flotiq-cli
   flotiq start [flotiqApiKey] [projectName] https://github.com/flotiq/gatsby-starter-event-calendar

   • flotiqApKey - Read and write API key to your Flotiq account
   • projectName - project name or project path (if you wish to start or import data from the current directory - use .)

2. You can also start the project from template using Gatsby CLI

   gatsby new event-calendar https://github.com/flotiq/gatsby-starter-event-calendar

3. Setup "Event" Content Type in Flotiq

   Create your Flotiq.com account. Next, create the Event Content Type:

   

   Note: You can also create Event using Flotiq REST API.

4. 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_API_KEY=YOUR FLOTIQ API KEY
   

5. Start developing

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

   cd event-calendar/
   npm install
   gatsby develop

   This step is optional and is not necessary if you used flotiq-cli to start the project.

   If you wish to import example events to your account, before running gatsby develop, install flotiq-cli, and run in project directory:

   flotiq import [flotiqApiKey] .

   It will add 5 events to your Flotiq account.

   Note: You need to put your Read and write API key as the flotiqApiKey for import to work. You don't need Event content type in your account. If you already have events with ids event-1, event-2, event-3, event-4, and event-5 they will be overwritten.

   Note: Import data may contain events in the past. You should change them to future dates to see events on the page.

6. 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!

7. Manage your posts using Flotiq editor

   You can now easily manage your posts using Flotiq editor

   

App Configuration

Inside the root folder, there is a file called appConfig.js, which allow you to customize the starter with your own preferences. It has the following structure:

{
  "title": "Gatsby Starter Event Calendar",
  "subTitle": "The easiest option to share events!",
  "maxAmountEvents": 2,
  "limitMonthInTheFuture": 2,
  "theme": {}
}

All these values can be changed by the developer and in case one of them it's not defined they all have default values. Inside the application, these values are being accessed using the component called ConfigContext which is a basic implementation of React Context.

Theming

Grommet has a prop called theme when the developer can set all the colors that are going to be used inside the application. Therefore there are some standard colors, like background and text, but there is a whole object just to configure how the Calendar is going to look like.

You can change any of the existing themes or create your own following this structure:

{
  "background": "white",
  "brand": "pink",
  "secondary": "violet",
  "focus": "pink",
  "text": "black",

  "calendar": {
    "today": {
      "background": "pink",
      "text": "violet",
      "border": "grey"
    },
    "day": {
      "background": "white",
      "text": "black",
      "border": "grey"
    },
    "past": {
      "background": "lightgrey",
      "text": "black",
      "border": "grey"
    },
    "empty": {
      "background": "lightblue",
      "border": "grey"
    },
    "weekdays": {
      "background": "white",
      "text": "black",
      "border": "grey"
    },
    "event": {
      "background": "white",
      "text": "black"
    },
    "modal": {
      "text": "black",
      "background": "white"
    }
  }
}

Inside the folder themes you can find a few examples I made to show how versatile is the theming in this application. Here are some screenshots:

Main

Base

Dark

Transparent

Deploy

You can deploy this project to Heroku in 3 minutes:

Or to Netlify:

Collaborating

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

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