Skip to content

๐Ÿ“ Gatsby.js starter blog template using a Medium theme; with features like Algolia Search, post claps, Prism highlighting, contact form, dark mode, +more.

License

Notifications You must be signed in to change notification settings

BrianRuizy/gatsby-medium-blog

Repository files navigation

Gatsby.js Medium Blog

Cover Cover (1)

Don't forget to leave a star โญ!

Features

  • ๐Ÿ“ฒ PWA ready, installable on Android and iOS
  • ๐Ÿ”Ž Algolia Search, search by all attributes
  • ๐Ÿ“ง Getform.io contact form with easy setup.
  • ๐Ÿ“ Blog ready, easily add your blog posts with MDX
  • ๐ŸŒ— Togglable dark mode
  • ๐Ÿ’ป SEO ready, option to Add meta description

Getting Started

Before developing and working with the codebase on your IDE of choice, there are some services to set up to get the project running successfully.

1. Algolia Search

Algolia Search environment variables are required in the project's .env file.

You will need to provide some information that identifies your account to the Algolia plugin and authorizes it to write data to it. If you donโ€™t already have an Algolia account, create one here. Then, go to the API Keys section of your Algolia profile.

There is already a file named .env.example in the project's root directory. You can rename this to .env and fill in the values or you can copy the contents of the file and paste them into your .env file as shown below.

GATSBY_ALGOLIA_APP_ID=<App ID>
GATSBY_ALGOLIA_SEARCH_KEY=<Search-Only API Key>
ALGOLIA_ADMIN_KEY=<Admin API Key>

2. GetForm

contact form is super easy to set up with getform.io. Simply add your API / endpoint URL to the action attribute of your form and you're good to go. See https://app.getform.io/forms for documentation. The location for this component is src/components/ContactDrawer.js.

  <form
    action="https://getform.io/f/faf8d119-4334-4fcc-ae56-2dc4de9cb453"
    method="POST"
  >
  ...
  </form>

Run the project

Not you must have already installed Node.JS and Gatsby CLI. See Gatsby's Development Environment Setup documentation for more details or if you have issues with the CLI installation.

nvm install 18
nvm use 18

npm install -g gatsby-cli
  1. Install project dependencies npm install. If having problems installing try with legacy peer dependencies, npm install --legacy-peer-deps.

  2. Start Developing. Navigate into your new siteโ€™s directory and start up the local server gatsby develop ๐ŸŽ‰.

See the reference guide to read more on other commands you can use with the Gatsby CLI.

Adding your blog posts

Adding your own content is super simple with the Jamstack design of the project. You won't need to write any HTML or CSS, just markdown (although you absolutely can if you wish to change the design or add your own features). The MDX posts are found in the content/posts/ directory. With MDX you can even add react components to your posts as found below.

Visit mdxjs.com to see what other cool things you can implement.

## Example header here

lorem ipsum dolor sit amet consectetur adipisicing elit. Quisquam, quidem quisquam.

<Alert severity="info">
  Visit <a href="https://python.org">here</a> for docs and examples.
</Alert>

image

About

๐Ÿ“ Gatsby.js starter blog template using a Medium theme; with features like Algolia Search, post claps, Prism highlighting, contact form, dark mode, +more.

Topics

Resources

License

Stars

Watchers

Forks

Languages