This repository has been archived by the owner on Jul 24, 2023. It is now read-only.
-
Notifications
You must be signed in to change notification settings - Fork 0
Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
- Loading branch information
Showing
8 changed files
with
20 additions
and
136 deletions.
There are no files selected for viewing
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -1,134 +1,5 @@ | ||
![](https://i.imgur.com/hWB1XRO.png) | ||
<p align="center"> | ||
<a href="https://www.rescue-amazonian-rainforest.com"><img src="./static/favicons/android-chrome-192x192.png"></a> | ||
</p> | ||
|
||
# Gatsby Starter Portfolio: Cara | ||
|
||
A portfolio starter for [Gatsby](https://www.gatsbyjs.org/). The target audience are designers and photographers. | ||
|
||
[Demo Website](https://portfolio-cara.netlify.com/) | ||
|
||
[![Deploy to Netlify](https://www.netlify.com/img/deploy/button.svg)](https://app.netlify.com/start/deploy?repository=https://github.com/LeKoArts/gatsby-starter-portfolio-cara) | ||
|
||
- TailwindCSS & Emotion | ||
- Gatsby v2 | ||
- React Spring | ||
- Playful & Colorful One-Page website with Parallax effect | ||
|
||
Based on [gatsby-tailwind-demo](https://github.com/jlengstorf/gatsby-tailwind-demo). | ||
|
||
## Why? | ||
|
||
If you want to quickly bootstrap a design/photography portfolio or use it as a foundation for your personal site the *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](https://www.lekoarts.de) or support me on [Patreon](https://www.patreon.com/lekoarts) to get some neat rewards (4K images, project files, tutorial insights). | ||
|
||
Also check out the other *gatsby-starter-portfolio*: | ||
- [gatsby-starter-portfolio-emma](https://github.com/LeKoArts/gatsby-starter-portfolio-emma) | ||
- [gatsby-starter-portfolio-emilia](https://github.com/LeKoArts/gatsby-starter-portfolio-emilia) | ||
- [gatsby-starter-portfolio-bella](https://github.com/LeKoArts/gatsby-starter-portfolio-bella) | ||
|
||
## Features | ||
|
||
- [React Spring](https://github.com/drcmda/react-spring) (Used for Parallax effect) | ||
- [TailwindCSS](https://tailwindcss.com/) & [Emotion](https://emotion.sh/) for styling | ||
- Use the full power of TailwindCSS while generating small styles (as unused data gets deleted) | ||
- SEO | ||
- Schema.org JSONLD | ||
- OpenGraph Tags | ||
- Twitter Tags | ||
- [Typefaces](https://github.com/KyleAMathews/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:** Gatsby **v2** is currently in Alpha and it will still take some time until it's officially released. Therefore you should expect some bugs. Also 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](https://nodejs.org/en/), the [Gatsby CLI](https://www.gatsbyjs.org/docs/) and [node-gyp](https://github.com/nodejs/node-gyp#installation) installed. The official Gatsby website also lists two articles regarding this topic: | ||
- [Gatsby on Windows](https://www.gatsbyjs.org/docs/gatsby-on-windows/) | ||
- [Check your development environment](https://www.gatsbyjs.org/tutorial/part-one/#check-your-development-environment) | ||
|
||
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 | ||
npm run develop | ||
``` | ||
|
||
### Adding new features/plugins | ||
|
||
You can add other features by having a look at the offical [plugins page](https://www.gatsbyjs.org/docs/plugins/) | ||
|
||
### 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. | ||
|
||
Make sure to use the right build command in your build settings e.g. if you use Netlify! | ||
Per default Netlify sets it to `gatsby build` but you have to use `yarn run build` to run postcss before building the Gatsby site. | ||
|
||
## 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: | ||
|
||
```JS | ||
module.exports = { | ||
pathPrefix: '/', // Prefix for all links. If you deploy your site to example.com/portfolio your pathPrefix should be "/portfolio" | ||
|
||
siteTitle: 'Cara - Gatsby Starter Portfolio', // Navigation and Site Title | ||
siteTitleAlt: 'Cara', // Alternative Site title for SEO | ||
siteUrl: 'https://portfolio-cara.netlify.com', // Domain of your site. No trailing slash! | ||
siteLanguage: 'en', // Language Tag on <html> element | ||
siteLogo: '/logos/logo-1024.png', // Used for SEO and manifest | ||
siteDescription: 'Playful & Colorful One-Page website with Parallax effect', | ||
|
||
siteFBAppID: '123456789', // Facebook App ID | ||
userTwitter: '@cara', // Twitter Username | ||
ogSiteName: 'cara', // Facebook Site Name | ||
ogLanguage: 'de_DE', // Facebook Language | ||
|
||
// Manifest and Progress color | ||
themeColor: tailwind.colors.orange, | ||
backgroundColor: tailwind.colors.blue, | ||
}; | ||
``` | ||
|
||
2) Use the `tailwind.js` file to configure TailwindCSS. Their [documentation](https://tailwindcss.com/docs/configuration) explains it step-by-setp. | ||
|
||
3) Modify the files in the `src/styles` directory. | ||
|
||
4) You can also place the icons somewhere else on the page, modify their animation and hide them on smaller screens: | ||
|
||
```JSX | ||
<SVG icon="triangle" className={hidden} 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 the `className={hidden}` | ||
- You can define the width via the TailwindCSS width [option](https://tailwindcss.com/docs/width) | ||
- The colors get defined via the TailwindCSS color [option](https://tailwindcss.com/docs/colors) | ||
- Please note that you will either have to define the color in `stroke` **or** `fill` depending on the icon. For referance 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 profits from increased performance. The installed fonts can be found in `src/pages/index.jsx`: | ||
|
||
```JSX | ||
import 'typeface-cantata-one'; | ||
import 'typeface-open-sans'; | ||
``` | ||
|
||
We use [typefaces](https://github.com/KyleAMathews/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`. | ||
### Source code of [Rescue Amazonian Rainforest's website](https://www.rescue-amazonian-rainforest.com) |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,8 @@ | ||
[Settings] | ||
ID = "rescue-amazonian-rainforest" | ||
|
||
[build] | ||
base = "/" | ||
publish = "public/" | ||
command = "wget -O content.tgz $RAR_CONTENT_URI && npm rebuild sharp && mkdir content && tar -xzf content.tgz -C content && yarn build" | ||
environment = { NODE_VERSION = "8.9.4" } |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.