File structure

Whilst the File Structure is not really important it can be important to link back to when you want to adjust something. So let us go through the important structure elements and leave out the really unimportant things. Here I will mark something on a scale:

  • 0: You are never going to need to adjust
  • 1: You should leave alone but I will describe it just in case
  • 2: These are things you will need to work with for some workflows.
  • 3: Almost all workflows interact with these files.

At the main level, we have a couple of files and folders:

  • .github/workflows: 1: This contains how to publish files
  • src: 3: This contains all the files which are the source to the entire website.
  • .gitignore: 0
  • README.md: 0
  • gatsby-config.js: 0
  • graphql-types.ts: 0
  • package.json: 0
  • tsconfig.json: 0
  • yarn.lock: 0

In the src folder we have:

  • @chakra-ui/gatsby-plugin: 0
  • assets: 2, This contains most of the static images for the webpage e.g. the homepage animation, the logo.
  • components: 1, The smaller components on webpages, e.g. the layout of pages
  • images: 2, the folder containing the images for articles and dynamic pages
  • md-texts: 2, contains the text for static pages e.g. the small about on the main page.
  • pages: 3, here are all the pages (dynamic and static) including news articles and other pages.
  • templates, 1: Contains the PDF view template
  • constants.ts, 0
  • md-graphql.tsx, 0