Skip to content

SPA (React) for displaying project release notes & status using GitHub API

License

Notifications You must be signed in to change notification settings

dariodumlijan/project-status

Repository files navigation

Project Status

This project is built using VITE with React TypeScript template

SPA (React) for displaying project release notes & status using GitHub API

Using GitHubs' API we are getting

preview

Deployment

Setup GitHub token

You can find how to get a GitHub access token in GitHubs' documentation

The token only needs Read-only repo access to:

  • Releases
  • Issues

Setup GitHub actions

Add the secrets/variables with the exact names listed below to you repos settings for actions

This will enable the GitHub action workflow for building and deploying the app to pass these values to the build so your app can communicate with GitHubs' API

Secrets

ACCESS_TOKEN="<your_github_token>"

Variables

REPO_NAME="project-status"
REPO_OWNER="dariodumlijan"
STATUS_ISSUE_NUMBER="1"

Setup GitHub pages

ATM there is some known problems when deploying to GitHub pages using tags The current workaround for this can be found here

The quick quide

  1. Go to project Settings > Pages > Build and deployment
    1. Set "Source" to "GitHub Actions"
  2. Go to project Settings > Environments
    1. If not already there, create an environment called github-pages
    2. Set "Deployment branches" to "All branches"

Deploy the app

Triggering the deploy job can be achieved in three ways:

1. Via GitHub Project Page

Looking at the project main page on GitHub, on the right-hand side column, there is a section "Releases".

Click on the button "Create a new release".

Follow instructions, it is required to enter a tag such as "v1.0.0"

2. Via Bash Script - Remotely

Using the script that lives in scripts/deploy.sh, you can call:

yarn deploy --{TYPE}

Where {TYPE} can be major, minor or patch

3. Via Console using GIT - Remotely

Go to the root of the project that was previously pulled from git. In the console (always increment in the next release):

git tag v1.0.0
git push origin --tags

Development

Requirements

Node.js & yarn

Node version >=20.0.0 and up needed to run the React scripts. And yarn to run the scripts and handle dependencies.

Project .env variables

VITE_GITHUB_ACCESS_TOKEN="<your_github_token>"
VITE_GITHUB_REPO_NAME="project-status"
VITE_GITHUB_REPO_OWNER="dariodumlijan"
VITE_GITHUB_STATUS_ISSUE_NUMBER="1"

Setup

Run the following commands to setup the project

~ cp .env.example .env
~ yarn install

Commands

Install node dependencies:

yarn (install)

Run dev server for development in the browser:

yarn dev

To build application for production:

yarn build

Run test handled by vitest:

yarn test

Get test coverage report:

yarn test:coverage