SarthakSKumar / Hackfest-2024-Website

Official Repository of Hackfest 2024 website.

Home Page:https://hackfest.dev

Geek Repo:Geek Repo

Github PK Tool:Github PK Tool

Official website of Hackfest '24

Hackfest '24, a 3-day national level hackathon hosted by Finite Loop Club from April 5th to 7th, 2024, at NMAM Institute of Technology, focused on the theme "Retrofuturism: Hack the Timestream”. Hosted by Finite Loop Club – NMAM Institute of Technology, Nitte, and proudly powered by EGDK India Pvt. Ltd., along with co-sponsorship from Niveus Solutions Pvt. Ltd. and the Global Point - Study abroad.

GitHub stars GitHub stars

Table of Contents

Features

  • Retrofuturism theme based Landing page
  • Paperless system with 5 Robust dashboards with extensive features for Admin, Team, Organiser, Volunteer, Validator
  • Hackathon Registration multi-step form with collecting details, team formation & idea submission
  • Team Management feature with Create/Join team, Delete/leave team
  • User Profile Management
  • Dynamic FAQ section with anonymous QnA

Built with

                                         

  • Next JS: React-based framework for building server-side rendered and statically exported web apps.
  • Typescript: Statically typed superset of JavaScript, adds type annotations to enhance code reliability & readability
  • TailwindCSS: Utility-first CSS framework
  • Azure PostgreSQL: Fully-managed database as a service with built-in capabilities, such as high availability and intelligence.
  • tRPC: Provides a simple, type-safe way to build APIs for TS & JS
  • zod: Type-safe, instance-based validation library for JavaScript.
  • React-query: Library for fetching, caching and updating asynchronous data in React apps
  • Prisma ORM: Modern, type-safe ORM for Node.js and TS.
  • GSAP: A JavaScript library for creating high-performance animations and interactive experiences.
  • Cloudinary: Cloud-based image and video management service that provides functionalities like storage, optimization, manipulation, and delivery of media assets.
  • shadcn/ui: Beautifully designed components that you can copy and paste into your apps. Accessible. Customizable. Open Source.
  • Sonner: An opinionated toast component for React.

Note This project was bootstrapped with create-t3-app

Project Setup

  1. Fork the project to your account
  2. Clone your fork to your local system
git clone <your fork URL here>
  1. Install the dependencies:

Note We prefer bun, but you can use npm or pnpm in incompatibility cases.

bun i
  1. Generate prisma client
bunx prisma generate
  1. Copy and Rename the .env.example to .env, place it in the root directory and fill the essential vars.
cp .env.example .env

Warning Do not rename the original .env.example, it is used to keep track for env vars list as .env with values is gitignored

  1. Run the development server:
bun dev

Open port 3000 on localhost with your browser to see the website.

Additional:

bunx prisma studio

to use Prisma Studio(visual editor).

Open port 5555 on localhost with your browser.

Contributors

License

License

This repository is licensed under Apache License 2.0

Appendix

About

Official Repository of Hackfest 2024 website.

https://hackfest.dev

License:Apache License 2.0


Languages

Language:TypeScript 98.1%Language:CSS 0.9%Language:JavaScript 0.8%Language:Shell 0.2%