Welcome to the PV Website repo! This is the source code of our website. Before contributing to the codebase you MUST read the following information. If you're a fullstack Next.js pro you can quickly skim this.
This is a Next.js project bootstrapped with create-next-app.
If you're new to Next.js development please start by reading the docs to get a understanding of how a Next.js site works. The underlying reactive web development framework is React, the linked page has a great tutorial for getting you acquainted quickly.
The language used in this project is Typescript which is a typed version of JavaScript. Please take a moment to review Typescript basics and best practices before getting started.
By continuing with development you are agreeing that you understand these frameworks and will attempt to work within the best practices and conventions.
Check out a new branch from dev before you begin working on any new feature. If you do not understand the previous sentence see git - the simple guide for a primer.
BEFORE running the server you must have Node.js installed on your machine. We officially use the 24.19.0 LTS version of Node but backward compatibility means you should be able to use any LTS >= 20.19.1 to run the server.
AFTER installing Node.js you MUST install pnpm to manage the dependencies for this project. We do NOT use npm, if you use npm your builds will fail!
The easiest way to install pnpm is via npm after installing Node.js. Otherwise visit the linked page above to install it on your machine.
npm install -g pnpm@latest-10First, install the dependencies,
pnpm installNext, in the .env.example file you'll see the list of required variables for proper function of the development server. Below is how you should configure each variable as of writing. All requests for credentials should be directed to a member of engineering team leadership on Discord.
# $PROJECT_DIR/.env
# Does not need to change
SITE_URL="http://localhost:3000"
# api vars
PV_WEBSITE_API_URL="https://devapi.progressivevictory.win"NOTE: If you have access to the-local-setup, the .env files are not needed.
Finally, run the development server
pnpm devOpen http://localhost:3000 with your browser to see the result. Upon saving your work the server automatically (hot) reloads with your changes.
Only certain users have the ability to deploy branches on Vercel. Create a PR and request help from a member of engineering team leadership, or attend coding team meeting Mondays at 5PM PST / 8PM EST to have your PR approved.
To learn more about Next.js, take a look at the following resources:
- Next.js Documentation - learn about Next.js features and API.
- Learn Next.js - an interactive Next.js tutorial.
You can check out the Next.js GitHub repository - your feedback and contributions are welcome!
Make sure you run the setup steps first:
npx playwright install --with-depspnpm run testMerge ticket branch -> dev as a squash, covering up our sins in the review process Merge dev -> main as a merge, allowing dev and main to share a history and compare histories properly