/personal-site

my personal site

Primary LanguageJavaScriptMIT LicenseMIT

Gatsby Starter Portfolio: Cara

Demo Website

  • TailwindCSS & styled-components
  • React Spring
  • Playful & Colorful One-Page website with Parallax effect

Thanks to @bradlc’s work on babel-plugin-tailwind-components, we can easily get the power of Tailwind without the stylesheet bloat by passing Tailwind classes into styled-components with Babel macros 🎉.

Why?

If you want to quickly bootstrap a design/photography portfolio or use it as a foundation for your personal site, the starters in gatsby-starter-portfolio are a perfect fit for you! The project's goal is to offer minimalistic and fast websites.

I hope you like my starters and create something awesome! To see some of my work, you can visit my website or support me on Patreon to get some neat rewards (4K images, project files, tutorial insights). Every pledge on Patreon helps me create more free starters!

Also, check out the other themes for gatsby-starter-portfolio:

Check out the Gatsby Starter Portfolio Overview!

Features

  • React Spring (Used for Parallax effect)
  • TailwindCSS & styled-components for styling
    • Use the full power of TailwindCSS while generating small styles (as unused data gets deleted)
    • Uses tailwind.macro (Babel macro) to have hot-reloading of Tailwind styles
  • SEO
    • Schema.org JSONLD
    • OpenGraph Tags
    • Twitter Tags
  • Typefaces for quicker font loading
  • Offline Support
  • WebApp Manifest Support
  • Responsive images
    • The right image size for every screen size
    • Traced SVG Loading (Lazy-Loading)
    • WebP Support

Please note: The parallax effect can be quite heavy for some older CPUs and the site uses some newer CSS features which will result in incompatibility with older browsers.

Getting Started

Check your development environment! You'll need Node.js, the Gatsby CLI and node-gyp installed. The official Gatsby website also lists two articles regarding this topic:

To copy and install this starter run this command (with "project-name" being the name of your folder you wish to install it in):

gatsby new project-name https://github.com/LekoArts/gatsby-starter-portfolio-cara
cd project-name
npm run dev

Adding new features/plugins

You can add other features by having a look at the official plugins page.

Building your site

npm run build

Copy the content of the public folder to your webhost or use a website like Netlify which automates that for you.

Configuration

You have multiple options to configure this project.

  1. Use the config/website.js to configure data passed to the SEO component and other parts of the Gatsby site:

  2. Use the tailwind.js file to configure TailwindCSS. Their documentation explains it step-by-step.

  3. Modify the files in the src/styles directory.

  4. Modify the sections in the src/views directory. They contain the Dividers & SVG icons.

  5. You can also place the icons somewhere else on the page, modify their animation and hide them on smaller screens:

  <SVG icon="triangle" hideMobile width={48} stroke={colors.orange} left="10%" top="20%" />
  <SVG icon="hexa" width={48} stroke={colors.red} left="60%" top="70%" />
  <SVG icon="box" width={6} fill={colors['grey-darker']} left="60%" top="15%" />
  • For icon, you have the options: triangle, circle, arrowUp, upDown, box, hexa
  • If you want the SVG to be hidden on mobile view, add hideMobile to the SVG component
  • You can define the width via the TailwindCSS width option
  • The colors get defined via the TailwindCSS color option
    • Please note that you will either have to define the color in stroke or fill depending on the icon. For reference, have a look at the currently used SVGs
  • The options left and top position the icon relatively to its parent container
  • You can also wrap the SVGs with <UpDown /> or <UpDownWide /> to animate them

Typography

Instead of relying on Google's CDN to host its fonts, this site self-hosts the fonts and therefore benefits from increased performance. The installed fonts can be found in src/components/Layout.jsx:

import 'typeface-cantata-one';
import 'typeface-open-sans';

This starter uses typefaces by Kyle Mathews. Have a look at the repository if you want to install & use other fonts.

You'll also need to configure fonts in tailwind.js to reflect the changes. You then can use the fonts with font-sans and font-serif.