The frontend application for HackCC of Spring 2025 that serves as the main website for hackathon particpants and as the an interface for organizers, sponsors or volunteers to use.
To start contributing to this repository, please review all the markdowns in docs folder that is in the client folder (the src folder for our Next app).
It will be based loosely on Bulletproof React
Important
We are using a library component called shadcn. Consider checking their documentation here if you plan on using, or modifying an existing component that utilizes a shadcn component. Do not modify any content in src/components/ui unless given explicit permission to. You can add components to it through using shadcn's command, but you shouldn't remove or edit any component that are used.
Follow the instructions below to run the application locally on your computer.
Requirements to deploy and run this project
Please use the following extension in order to comply to the project's stand
Enter your working repository/folder and clone the repository
git clone git@github.com:HackCC-Official/spring2025.gitThen enter directory and install the dependencies
cd spring2025/client
npm installUse the following env template or the one found .env.example in order to deploy to production or development server
# for deploying to prod or dev
MAIN_HOSTNAME=
MINIO_HOSTNAME=
NEXT_PUBLIC_QR_SERVICE_URL=
NEXT_PUBLIC_OUTREACH_SERVICE_URL=
NEXT_PUBLIC_ACCOUNT_SERVICE_URL=
NEXT_PUBLIC_APPLY_SERVICE_URL=
NEXT_PUBLIC_SUPABASE_URL=
NEXT_PUBLIC_SUPABASE_ANON_KEY=
NEXT_PUBLIC_PRODUCTION=
Important
For any new environmental variables, add them to the:
- Dockerfile build and runtime steps
- Docker compose build context
First, run the development server:
npm run devOpen http://localhost:3000 with your browser to see the result.
You can start editing the page by modifying app/page.tsx. The page auto-updates as you edit the file.
This project uses next/font to automatically optimize and load Geist, a new font family for Vercel.