📝 Hack4Impact-UMD Application Portal

This repository contains the source code for the Hack4Impact-UMD Application Portal. The interface includes features for applicants to submit and view the status of their applications, and features to make reviewing applications more efficient for club members.

In addition, the project is integrated with Professor, our autograder service.

✨ Features

• Role-specific workflows for applicants, reviewers, board members, and admins.
• Dynamic applications support role-specific sections, markdown, file uploads, autosave, and validation.
• Review interface with access to rubrics, notes, command pallete, and autosave.
• Admin dashboards manage review status, assignments, decisions, and confirmations.
• Auto-assignment algorithm generates applicant-to-reviewer matches.
• Automation tools duplicate forms, update due dates, activate forms, create internal applicants, etc.
• Form and rubric builders provide JSON editors, live previews, validation, and upload.
• CSV exports download and organize applicant and review data.
• Autograder integration publishes and tracks grading jobs for engineering applicants.

🛠️ Tech Stack

• Language: TypeScript
• Package Manager: pnpm
• Linter and Formatter: oxlint + oxfmt

Frontend

• Framework: React
• Build Tool: Vite
• Styling: Tailwind CSS
• UI Components: shadcn/ui, Radix UI
• Data Fetching: TanStack Query
• Routing: React Router

Backend

• Runtime: Node.js
• Framework: Express
• Platform: Firebase (Cloud Functions, Firestore, Authentication, Storage)
• Schema Validation: Zod
• Task Queue: Cloud Tasks

🚀 Building and Running Locally

1. From the app-portal directory, install all dependencies with:

   pnpm install

2. Build all workspaces:

   pnpm build

3. Run the frontend server:

   pnpm --filter frontend dev

4. Run the backend server:

   pnpm --filter functions serve

In addition:

• Set up .env files with the templates available at frontend/.env.example and backend/functions/.env.example.
• Set up backend emulators with the Firebase Emulator Setup Guide.
• Set up pre-commit hooks with pip install pre-commit and pre-commit install

🖼️ Screenshots

Note: Some of these may be outdated

📞 Team Contacts

Name	Role	Contact	Email
Ramy Kaddouri	Tech Lead	Slack	TODO
Lance Uymatiao	Tech Lead	Slack	lanceu0128@gmail.com