Blog and Portfolio website

Screenshot

The home page

Gatsby v3 integrated with Contentful

Demo

The website is live at: https://www.lakum.in

Features

Integration with Contentful - automated content model & demo setup
Responsive/adaptive images via gatsby-plugin-image
Uses utility-first TailwindCSS framework
Integration with Mailchimp - newsletter form
Responsive design (desktop / mobile)

Getting started

Install Node package manager (NPM) (if you haven't already).

Requirements

To use this project you have to have a Contentful account. If you don't have one yet you can register at www.contentful.com/sign-up.

Forked from

$ git clone git@github.com:wkocjan/gatsby-contentful-portfolio.git
$ npm install

Set up of the needed content model and create a configuration file

This project comes with a Contentful setup command npm run setup.

This command will ask you for a space ID, and access tokens for the Contentful Management and Delivery API and then import the needed content model into the space you define and write a config file (.env).

This command uses content from export.json to bootstrap your portfolio with test data. To use your blog content from Contentful, export the data as JSON to contentful folder. Update the import statement in the setup.js file and run npm run setup command.

Set up Mailchimp

If you want to use built-in integration with Mailchimp, please provide your unique endpoind URL in the .env file (MAILCHIMP_ENDPOINT variable).

Follow this instruction to get the endpoint value.

Crucial Commands

This project comes with a few handy commands for linting and code fixing. The most important ones are the ones to develop and ship code. You can find the most important commands below.

`gatsby develop`

Run in the project locally.

`gatsby build`

Run a production build into ./public. The result is ready to be put on any static hosting you prefer.

Look at package.json for additional commands.

Contentful CLI

After initial login, the CLI stores your managementToken in ~/.contentfulrc.json

List all spaces of a Contentful space

contentful space list

List all content-types of a Contentful space

contentful content-type --space-id SPACE_ID list

Export a Contentful space

contentful space export --space-id SPACE_ID

Netlify CLI

After initial authorization, the CLI stores auth token in ~/.netlify/config.json

Netlify command

netlify init - to initialize netlify setup
netlify open:admin - open Netlify admin site
netlify open:site - open deployed site
netlify deploy - trigger a deploy on Netlify

Dockerize

docker build . -t g-portfolio:1.0.0

docker run -d -p 8000:8000 --name g-portfolio g-portfolio:1.0.0

# Build images before starting containers.
docker-compose up --build

# Run built image in a container
docker-compose up

# Stops and removes container
docker-compose down

Troubleshooted Issues

Issue #17173: Unable to find plugin "gatsby-plugin-sharp"

Remove node_modules. Remove package-lock.json
yarn upgrade --latest && gatsby clean
Use yarn instead of npm yarn Install
yarn run build

Issue 19108: Generating JavaScript bundles failed on Gatsby v2.17+

delete your .cache and public folder and try again. If that doesn't work delete your package-lock.json or yarn.lock and node_modules and try a npm install again.

Issue #3432 - Error: Module not found: Error: Cannot resolve module 'react-helmet'

Install react-helmet and gatsby-plugin-react-helmet@latest

Issue #2088 - How to use childMarkdownRemark

Install gatsby-transformer-remark as a dependency.

Issue #1227 - React-Hot-Loader: react-🔥-dom patch is not detected. React 16.6+ features may not work.

In package.json file, replace react-dom inside dependencies with @hot-loader/react-dom

kranthilakum / g-portfolio

readme