/payid.org

Gatsby based static web application for the PayID marketing site

Primary LanguageTypeScript

PayID

PayID Marketing Site

This repository powers the PayID.org web application built using Gatsby

πŸš€ Quick start

  1. Clone the PayID.org repository.

    Use git to pull down the PayID.org repository.

    git clone https://github.com/payid-org/payid.org.git
  2. Start developing.

    Navigate into PayID.org's directory, install the packages, and start it up.

    cd payid.org/
    npm i
    npm run start
  3. Start editing!

    PayID.org is now running at http://localhost:8000!

    Save your changes and the browser will update in real time!

🧐 What's inside?

A quick look at the top-level files and directories you'll see in the PayID.org repository.

.
β”œβ”€β”€ .github
β”œβ”€β”€ .vscode
β”œβ”€β”€ node_modules
β”œβ”€β”€ src
β”œβ”€β”€ static
β”œβ”€β”€ .dockerignore
β”œβ”€β”€ .gitignore
β”œβ”€β”€ .gitlab-ci.yml
β”œβ”€β”€ Dockerfile
β”œβ”€β”€ gatsby-browser.js
β”œβ”€β”€ gatsby-config.js
β”œβ”€β”€ package.json
β”œβ”€β”€ package-lock.json
β”œβ”€β”€ README.md
β”œβ”€β”€ tailwind.config.js
└── tsconfig.json
  1. /.github: This directory contains github configuration files such as the CODEOWNERS file.

  2. /.vscode: This directory contains the recommended vscode extensions and settings for the editor.

  3. /node_modules: This directory contains all of the modules of code that our project depends on (npm packages) are automatically installed when using the npm i command.

  4. /src: This directory contains all of the code related to what you will see on the front-end of PayID.org. src is a convention for β€œsource code”.

  5. /static: This directory contains any files or assets that will be accessible at the root of https://payid.org. For instance favicon.ico can be accessed at https://payid.org/favicon.ico.

  6. .dockerignore: This is a configuration file for Docker. Dockerignore tells our docker build to exclude certain directories from the docker container.

  7. .gitignore: This is a configuration file for git. The gitignore tells us which files to exclude in our committed source code.

  8. .gitlab-ci.yml: This is a configuration file for Gitlab CI. This is the required steps that setups up our continuous deployment as well as tests our code to ensure our code meets basic standards before being merged into github.

  9. Dockerfile: This is a configuration file for Docker. The Dockerfile tells the docker container how to process and deploy the code.

  10. gatsby-browser.js: This file is where Gatsby expects to find any usage of the Gatsby browser APIs. These allow customization/extension of default Gatsby settings affecting the browser.

  11. gatsby-config.js: This is the main configuration file for a Gatsby site. We specify information about PayID.org like the site title and description, which Gatsby plugins we include, etc. (Check out the gatsby config docs for more detail).

  12. 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.

  13. package-lock.json (See package.json below, first). This is an automatically generated file based on the exact versions of your npm dependencies that were installed. (You won’t change this file directly).

  14. README.md This the code that hosts the helpful content you are reading right now.

  15. tailwind.config.js: This is the main css configuration file that holds all of our theming configuration. This is for the CSS framework tailwind which we use for PayID.org.

  16. tsconfig.js: This is the configuration file for our typescript configuration. We use a strict configuration that doesn't allow any loose typings in order to maintain a high code quality.