π¨ Gatsby WordPress themes
- A Gatsby theme for WordPress, using Decoupled Architecture.
- Front end in React
- Backend in WordPress.
Video Demo
***
π₯ Features
- Uses React with Gatsby ( Blazing Fast )
- PWA ( Works Offline )
- Image Optimization ( blur effect )
- ACF
- GraphQL ( with wp-graphql on WordPress )
- Blog Page with Pagination
- Offline Search Feature
- Categories, Archive Page, Custom Home Page
- Custom Widgets, Menus
- Yoast seo support
- Supports Post and Page building with Elementor
π Live Demo
π¨βπ» Maintainer
Name | Github Username |
---|---|
Imran Sayed | @imranhsayed |
π Set Up
Gatsby Setup
- Rename
.env-example
in site directory file to.env
and add the following, in thissite
directory of this repo.
- Also set the
GATSBY_ELEMENTOR_SUPPORT
andGATSBY_SIDEBAR
if you would
like the theme to support page and post building with elementor and sidebar.
GATSBY_WORDPRESS_SITE_URL=xxx
FRONTEND_URL=xxx # Set this to http://localhost:3000 for development and your live front-end gatsby url for production.
GATSBY_ELEMENTOR_SUPPORT=true
GATSBY_SIDEBAR=false
WordPress Setup
- On your WordPress site, download, Upload and activate all the plugins from wordpress/plugins folder of this repo, into your WordPress Site.
a. Headless CMS
b. wp-graphql
c. wp-graphiql
d. ACF WordPress plugin
e. wp-graphql-acf
f. Yoast-SEO
g. wp-graphql-yoast-seo
-
- Set Header menu as
HCMS Header Menu
- Set Header menu as
-
You can also set text widgets in #HCMS Footer #1 and #HCMS Footer #2 under Appearance > Widgets in WordPress.
-
Import all the ACF data from
wordpress/acf-data
json file of this repo, into WordPress by going to WordPress Dashboard > Custom Fields > Tools > Import -
Create a Home Page ( if there isn’t one already )and make sure you have a home page and Location rule is set to Home page.
-
Add the ACF required data on the Home page from WordPress Dashboard.
-
If isn’t already set your site title, description and logo from WordPress customizer.
Open the source code and start editing!
npm run dev
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.
π Development
- Navigate into siteβs directory.
yarn install # Run this for the first time.
npm run dev # During development.
npm run build # When ready for production.
π Storybook:
For Storybook:
cd package/gatsby-wordpress-theme-phoenix
npm run storybook
π¦ Adding/Removing a new package to site folder
yarn workspace site add package-name
yarn workspace site remove package-name
π¦ Adding/Removing a new package to gatsby-wordpress-theme-phoenix folder
yarn workspace gatsby-wordpress-theme-phoenix add package-name
yarn workspace gatsby-wordpress-theme-phoenix remove package-name
π§ What’s inside?
A quick look at the top-level files and directories you’ll see in a Gatsby project.
.
βββ node_modules
βββ demos
βββ packages
βββ src
βββ .gitignore
βββ .site
βββ gatsby-browser.js
βββ gatsby-config.js
βββ gatsby-node.js
βββ gatsby-ssr.js
βββ package-lock.json
βββ package.json
βββ README.md
-
/node_modules
: This directory contains all of the modules of code that your project depends on (npm packages) are automatically installed. -
/src
: This directory will contain all of the code related to what you will see on the front-end of your site (what you see in the browser) such as your site header or a page template.src
is a convention for βsource codeβ. -
.gitignore
: This file tells git which files it should not track / not maintain a version history for. -
.prettierrc
: This is a configuration file for Prettier. Prettier is a tool to help keep the formatting of your code consistent. -
gatsby-browser.js
: This file is where Gatsby expects to find any usage of the Gatsby browser APIs (if any). These allow customization/extension of default Gatsby settings affecting the browser. -
gatsby-config.js
: This is the main configuration file for a Gatsby site. This is where you can specify information about your site (metadata) like the site title and description, which Gatsby plugins youβd like to include, etc. (Check out the config docs for more detail). -
gatsby-node.js
: This file is where Gatsby expects to find any usage of the Gatsby Node APIs (if any). These allow customization/extension of default Gatsby settings affecting pieces of the site build process. -
gatsby-ssr.js
: This file is where Gatsby expects to find any usage of the Gatsby server-side rendering APIs (if any). These allow customization of default Gatsby settings affecting server-side rendering. -
LICENSE
: Gatsby is licensed under the MIT license. -
package-lock.json
(Seepackage.json
below, first). This is an automatically generated file based on the exact versions of your npm dependencies that were installed for your project. (You wonβt change this file directly). -
package.json
: A manifest file for Node.js projects, which includes things like metadata (the projectβs name, author, etc). This manifest is how npm knows which packages to install for your project. -
README.md
: A text file containing useful reference information about your project.
Useful Links
- Setting workspaces with yarn for theme development
- Installing a gatsby theme and setting it up.
Deployment
With vercel
-
Signup on vercel.com
-
On vercel, make sure you add these from settings of the project:
From CLI:
-
npm i -g vercel
-
Now in the project root run
vercel
-
Add the following configurations
- build command:
npm run build
- output directory:
site/public
- development command:
npm run dev
- root directory:
/