A portfolio based on your latest Instagram posts, implemented with Uber's Base Web design system. It features out-of-the-box responsive layouts, easy-to-implement components and CSS-in-JS styling.
Check the Gatsby Starter here.
- Plug & Play configuration β All you need is an Instagram username!
- Lightweight & Minimalist page structure. Let your work show itself.
- Fully responsive design: Mobile, Tablet & Desktop supported.
- Continuous deployment via Netlify or Zeit.
- Functional components so you can take advantage of React Hooks.
- Google Analytics ready!
-
Create a Gatsby site.
Use the Gatsby CLI to create a new site, specifying this starter.
# create a new Gatsby site using the default starter gatsby new my-default-starter https://github.com/timrodz/gatsby-starter-instagram-baseweb
Note: You can change
my-default-starter
to whatever name you prefer. -
Start developing.
Navigate into your new siteβs directory and start it up.
cd my-default-starter/ gatsby develop
-
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 the
my-default-starter
directory in your code editor of choice and editsrc/pages/index.js
. Save your changes and the browser will update in real time!
In order to start showing posts from the instagram profile of your choice, you must do the following steps:
This is the main configuration file for your app. It's in charge of specifying the settings of gatsby-config.js
(See in section below) as well as the SEO of your website.
- social.instagram: tells the Instagram API the username to get posts from. If the url is
https://www.instagram.com/natgeotravel/
, the username will benatgeotravel
. - googleAnalyticsId: If you don't know how to find your id, please see this post.
Note: If you change certain variables, you might have to restart your app by interrupting the process and re-running gatsby develop
.
module.exports = {
// Name of your site. Can be the name of a brand, or your personal name.
title: 'Gatsby Starter',
// What's the purpose of this website? What can we expect from it?
description:
`A portfolio based on your latest Instagram posts, implemented with Uber's Base Web Design System.`,
// Your legal name.
legalName: 'Gatsby Starter',
// URL to this website. If you bought `www.domain.com`, then it will be `www.domain.com`.
url: 'https://www.robonomy.com',
// Favicon that will display on browsers.
logo: 'static/images/favicon.png',
// Who made this website?
author: 'Juan Alejandro Morais',
// What's the website of the author?
authorUrl: 'https://www.timrodz.com',
// Your social media presence, in the form of usernames.
social: {
// tells the Instagram API the username to get posts from.
// If the url is `https://www.instagram.com/natgeotravel`, your username is `natgeotravel`.
instagram: 'natgeotravel',
// Optional
twitter: '@NatGeoTravel',
},
socialLinks: {
// Complete URL verison of `social.instagram`.
instagram: 'https://www.instagram.com/natgeotravel',
// Optional
twitter: 'https://twitter.com/NatGeoTravel',
},
// If applicable, your Google Analytics crawl ID.
googleAnalyticsId: 'UA-XXXXXXXX-X',
// Colours that represent your website.
themeColor: '#000',
backgroundColor: '#fff',
// No more information than City Country due to privacy concerns.
address: {
city: 'City',
country: 'Country',
},
// Basic contact details.
contact: {
// Email address to contact you.
email: '[email protected]',
},
// When was this website created?
foundingDate: '2020',
};
A quick look at the top-level files and directories you'll see in a Gatsby project.
.
βββ node_modules
βββ src
β βββ components
| β βββ common
| β βββ theme
β βββ pages
βββ data
β βββ config
βββ static
β βββ images
βββ .gitignore
βββ .prettierignore
βββ .prettierrc
βββ .eslintrc.js
βββ gatsby-config.js
βββ LICENSE
βββ package.json
βββ yarn.lock
βββ 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β. -
/data
: This folder will contain all of the code related to website data structures.config.js
contains your personal information, and it will be populated for SEO. -
/static
: This directory will contain all assets i.e. images. Read how to use the static folder for more information. -
.gitignore
: This file tells git which files it should not track / not maintain a version history for. -
.prettierignore
: Tells our.prettierrc
file to ignore certain folders and/or files. -
.prettierrc
: This is a configuration file for Prettier. Prettier is a tool to help keep the formatting of your code consistent. -
.eslintrc.js
: This is a configuration file for ESLint. ESLint is a tool to help lint and enforce rules on your code. -
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). -
LICENSE
: Gatsby, and this starter, are licensed under the MIT license. -
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. -
yarn.lock
(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). -
README.md
: A text file containing useful reference information about your project.
Looking for more guidance? Full documentation for Gatsby lives on the website. Here are some places to start:
-
For most developers, we recommend starting with our in-depth tutorial for creating a site with Gatsby. It starts with zero assumptions about your level of ability and walks through every step of the process.
-
To dive straight into code samples, head to our documentation. In particular, check out the Guides, API Reference, and Advanced Tutorials sections in the sidebar.