Skip to content

Probably the simplest and the fastest app for high schools lookup

License

Notifications You must be signed in to change notification settings

po8klasie/web-frontend

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

72 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

po8klasie web frontend

🇵🇱 Prawdopodobnie najprostsza i najszybsza wyszukiwarka szkół średnich.

🇬🇧 Probably the simplest and fastest high schools lookup service.

Quick start

NOTE: This project relies on Next.js Framework.

  1. Clone this repo ⬇️
git clone https://github.com/po8klasie/web-frontend
  1. In root directory of the project, create .env file with specified environmental variables (see below) 📄

  2. Install dependencies using yarn 📦

yarn
  1. Run the project 🚀
yarn dev

Environmental variables

Name Required Description
API_URL ✔️ Url where the API is hosted (do NOT include a trailing slash)
APP_ENVIRONMENT e.g. production, test. It's used by Sentry and displayed in the footer.
APP_FRONTEND_RELEASE e.g. docker image tag. It's used by Sentry and displayed in the footer.
MAPBOX_ACCESS_TOKEN ✔️ Mapbox access token. (We'll be adding OSM support soon)
PUBLIC_SENTRY_DSN Sentry DSN. If it's not specified, Sentry client is not initialized.
POSTHOG_API_KEY Posthog API key. If it's not specified, Posthog Analytics client is not initialized.

NOTE: If you don't want to spin up local API server, for development purposes use https://test.po8klasie.pl/api as API_URL.

Linter & formatter

Available linter/formatter commands:

yarn lint:check
yarn format:check

yarn lint:fix
yarn format:write

What about the back-end?

If you want to develop front-end only, you are good to go! Just insert URL of the API server in .env file.

If you want to develop front-end simultaneously with back-end:

Self-hosting

We publish versioned ghcr.io/po8klasie/web-frontend docker image. Remember to set up env vars according to "Environmental variables" section.

You can find detailed guide of how to set up po8klasie for production use in our infra repo.

More resources

Team & our partners

This is a civic tech and open-source project crafted by volunteers. Core team members are listed on po8klasie.pl website.

Our partners: