{"id":16821932,"url":"https://github.com/bytrangle/gatsby-forestry","last_synced_at":"2026-01-03T21:51:57.612Z","repository":{"id":116642668,"uuid":"338599586","full_name":"bytrangle/gatsby-forestry","owner":"bytrangle","description":null,"archived":false,"fork":false,"pushed_at":"2021-03-01T13:08:37.000Z","size":74937,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"master","last_synced_at":"2024-10-14T11:01:25.548Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"SCSS","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/bytrangle.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2021-02-13T15:03:50.000Z","updated_at":"2021-03-01T13:08:39.000Z","dependencies_parsed_at":null,"dependency_job_id":"2a02a81d-62b2-43c7-add7-256b0a98ba2a","html_url":"https://github.com/bytrangle/gatsby-forestry","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bytrangle%2Fgatsby-forestry","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bytrangle%2Fgatsby-forestry/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bytrangle%2Fgatsby-forestry/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bytrangle%2Fgatsby-forestry/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/bytrangle","download_url":"https://codeload.github.com/bytrangle/gatsby-forestry/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":244073894,"owners_count":20393911,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2024-10-13T11:01:01.623Z","updated_at":"2026-01-03T21:51:57.573Z","avatar_url":"https://github.com/bytrangle.png","language":"SCSS","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003cp align=\"center\"\u003e\n  \u003ca style=\"padding-right: 16px;\" href=\"https://forestry.io\"\u003e\n    \u003cimg src=\"https://app.forestry.io/assets/forestry-logotype-pos-c71a6bd237d9199d0457ba2811553997ff5bab0d2cd0e740686ab26c00d9c240.svg\" width=\"112\" height=\"28\"\u003e\n  \u003c/a\u003e\n  \u003ca href=\"https://www.gatsbyjs.org/\"\u003e\n    \u003cimg src=\"/static/gatsby_logo.svg\" width=\"112\" height=\"28\"\u003e\n  \u003c/a\u003e\n\u003c/p\u003e\n\u003ch1 align=\"center\"\u003e\n  Brevifolia\n\u003c/h1\u003e\n\n## About\n\n[![Netlify Status](https://api.netlify.com/api/v1/badges/314f6fb1-b4a6-484a-ad3d-c26663a63bca/deploy-status)](https://app.netlify.com/sites/brevifolia-gatsby-forestry/deploys)\n\nBrevifolia is minimalist blog starter to get you going using [Forestry](https://forestry.io/) with [Gatsby](https://www.gatsbyjs.org/). Check out the demo [here](https://brevifolia-gatsby-forestry.netlify.com/)\n\nThis blog is statically generated by Gatsby, a rendered combination of react components and markdown files. It is preconfigured to work with Forestry as a way to manage your content. Forestry makes changes by editing markdown or data files, uploading media to the correct directory and committing these updates to your repo directly.\n\nThe styles were coded \u0026 designed by yours truly, using [scss](https://sass-lang.com/) with [css modules](https://github.com/css-modules/css-modules) (which are [inherently support by gatsby](https://www.gatsbyjs.org/docs/css-modules/)) and the [bem](http://getbem.com/) naming convetion. The font used is [Work Sans](https://fonts.google.com/specimen/Work+Sans). \n\n##  Quick Setup\n\n#### *Import Directly to Forestry*\n\n\u003ca href=\"https://app.forestry.io/quick-start?repo=kendallstrautman/brevifolia-gatsby-forestry\u0026engine=gatsby\"\u003e\n    \u003cimg alt=\"Import this project into Forestry\" src=\"https://assets.forestry.io/import-to-forestryK.svg\" /\u003e\n\u003c/a\u003e\n\n#### *Using the Gatsby CLI*\nIn your terminal, navigate to where you would like this blog to live, then run \n```bash \ngatsby new [SITE_DIRECTORY_NAME] https://github.com/kendallstrautman/brevifolia-gatsby-forestry\ncd [SITE_DIRECTORY_NAME]\nyarn dev \n```\n#### *Set-up Locally*\nIn your terminal, navigate to where you would like this blog to live, then run \n```bash\n#clone the repo\ngit clone git@github.com:kendallstrautman/brevifolia-gatsby-forestry.git\n\n#navigate to the directory\ncd brevifolia-gatsby-forestry\n\n#install dependencies \u0026 run dev server with yarn \nyarn install\nyarn dev\n\n#or with npm \nnpm install\nnpm run dev\n```\nA new browser window should open with the dev server running or you can navigate to localhost:8000 \n\n### Plugins\n\nWith Gatsby offering a plugin-rich ecosystem, there are a few key plugins that make this project possible. \n\n- [Gatsby-image](https://using-gatsby-image.gatsbyjs.org/) optimizes image loading and provides the correct file paths for output. \n- [Gatsby-transformer-remark](https://www.gatsbyjs.org/packages/gatsby-transformer-remark/?=gatsby-tranf) gives us access to and transforms the markdown files, using also [gatsby-remark-images](https://www.gatsbyjs.org/packages/gatsby-remark-images/?=gatsby-remark), [gatsby-remark-normalize-paths](https://www.gatsbyjs.org/packages/gatsby-remark-normalize-paths/?=gatsby-remark-no), \u0026 [gatsby-remark-relative-images](https://www.gatsbyjs.org/packages/gatsby-remark-relative-images/?=gatsby-remark-re) to make sure the content in the markdown works properly. \n- [Gatsby-transformer-yaml allows](https://www.gatsbyjs.org/packages/gatsby-transformer-yaml/?=gatsby-tranfor) us to use the data in .yaml files, feel free to add [gatsby-transformer-json](https://www.gatsbyjs.org/packages/gatsby-transformer-json/?=gatsby-tranfor) if you prefer that format for data files. \n- [Gatsby-plugin-sass](https://www.gatsbyjs.org/packages/gatsby-plugin-sass/?=gatsby-plugin-sass) lets us write styles using scss or sass. \n- [Gatsby-plugin-react-helmet](https://www.gatsbyjs.org/packages/gatsby-plugin-react-helmet/?=gatsby-plugin-react) extends the well-known react-helmet, allowing you to adjust content in the ‘head’ of your components. \n\n## Project Structure \n\n- Site-level configuration is stored in `config.json` so it can be exposed to Forestry. This file is loaded in the `gatsby-config.js` to configure Gatsby and all it to be accessible via siteMetaData in your graphql queries.\n- Access any of Gatsby's [browser api's](https://www.gatsbyjs.org/docs/browser-apis/) via the `gatsby-browser.js`, or load global styles etc.\n- Add and access plugin options or siteMetaData via `gatsby-config.js`\n- Access Gatsby's [node api's](https://www.gatsbyjs.org/docs/node-apis/) via `gatsby-node.js`. This is where the creation of new blog pages or nodes is handled. \n- Edit styles via `src/styles/...`\n- `content/`contains all your markdown blog posts, images \u0026 data files (e.g. authors list, info page data). \n- `src/pages` is a very important and required directory for Gatsby. This is where all your pages for the site live. \n- Blog posts are built from a template that can be accessed at `src/templates`. \n- The pages \u0026 template are comprised of components from `src/components`.\n\n## Using Forestry as your CMS\n\nThe `.forestry` directory contains all the settings information and frontmatter configuration to allow Forestry to setup the sidebar structure and editing capacity for this blog. After importing this blog into forestry, you can [access and edit](https://forestry.io/docs/editing/) all of the content via the sidebar. \n\nYou can add new blog posts, [data files](https://forestry.io/docs/editing/data-files/), or entire pages and sections to fit your needs. You can also [customize how media](https://forestry.io/docs/media/) is handled, by configurating gitLFS, Cloudinary, S3, or Netlify Large Media.\n\nYou can set up a [remote admin](https://forestry.io/docs/editing/remote-admin/) for content editors to log in directly to yoururl.com/admin to make content updates.\n\n### Instant Previews\n\nThe [instant preview](https://forestry.io/docs/previews/instant-previews/) method spins up the Gatsby development server for a long-lived preview that can quickly respond to content updates. When using instant previews, your preview command should be the develop command. The development server spawned by this command should be available over port 8080, and bind to 0.0.0.0. The forestry:preview command in this project's package.json will spin up a Gatsby dev server compatible with Forestry's instant previews.\n\n## Deploy Options\n\n[![Deploy to Netlify](https://www.netlify.com/img/deploy/button.svg)](https://app.netlify.com/start/deploy?repository=https://github.com/kendallstrautman/brevifolia-gatsby-forestry)\n\n[Netlify](https://www.netlify.com/blog/2016/09/29/a-step-by-step-guide-deploying-on-netlify/) is a great way to easily deploy sites. There's no special setup you need to do with Forestry to deploy with Netlify. When Forestry makes commits to your repo, Netlify will auto-trigger a rebuild / deploy when new commits are made.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbytrangle%2Fgatsby-forestry","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fbytrangle%2Fgatsby-forestry","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbytrangle%2Fgatsby-forestry/lists"}