Project - Zuchini

The official repository for Nitrutsav 2026

· Report Bugs . Add Features

Table of Contents

1. About The Project
2. Built With
3. Getting Started
   • Prerequisites
   • Contribution guidlines
   • Local Repository Setup
   • Running the project
4. License
5. DSC NIT Rourkela
6. Starware

About The Project

Nitrutsav is the annual literary and cultural festival of the National Institute of Technology, Rourkela. Recognized as one of Odisha’s largest student-run events, it brings together participants from across India for competitions and performances in music, dance, drama, literature, fine arts, and more.

This year, the complete technical infrastructure and digital experience for the fest is being developed in collaboration with DSC NIT Rourkela, providing an end-to-end platform for registrations, event management, and participant interaction.

Built With

Following technologies and libraries are used for the development of this website

• React 19 - Frontend library
• Next.js 16 - React framework
• TypeScript 5 - Type safety
• Tailwind CSS 4 - Styling
• Firebase - Backend services
• Flutter - Mobile App
• Turborepo - Monorepo build system
• pnpm - Package manager
• Zod - Schema validation

Getting Started

To setup the project locally follow the steps below.

Prerequisites

• Node.js (version 18 or higher)

  # macOS (Homebrew)
  brew install node
  
  # Windows (Chocolatey)
  choco install nodejs
  
  # Linux (Debian/Ubuntu)
  sudo apt install nodejs
  
  # Linux (Arch)
  pacman -S nodejs
  
  # Linux (Fedora)
  dnf module install nodejs
  
  # Verify installation
  node --version

• pnpm (version 9.0.0)

  # Install using npm
  npm install -g [email protected]
  
  # Or using Corepack (recommended)
  corepack enable
  corepack prepare [email protected] --activate
  
  # Verify installation
  pnpm --version

• Git

  # macOS (Homebrew)
  brew install git
  
  # Windows (Chocolatey)
  choco install git
  
  # Linux (Debian/Ubuntu)
  sudo apt-get install git
  
  # Linux (Arch)
  pacman -S git
  
  # Linux (Fedora)
  sudo dnf install git
  
  # Verify installation
  git --version

Contribution guidlines

Contributions are welcome 🎉🎉

NOTE 1: Please abide by the Contributing Guidelines.

NOTE 2: Please abide by the Code of Conduct.

Local Repository Setup

Please refer to the project's style and contribution guidelines for submitting patches and additions. In general, we follow the "fork-and-pull" Git workflow.

1. Fork the repo on GitHub
2. Clone the project to your local system
3. Commit changes to your own separate branch
4. Push your work back up to your fork
5. Submit a Pull request so that we can review your changes

Running the project

This is a monorepo managed with Turborepo and pnpm workspaces. The project uses pnpm, not npm or yarn. It is strictly advised to stick with pnpm to avoid dependency conflicts.

# Install dependencies
pnpm install

# Run all apps in development mode
pnpm dev

# Run specific app (web runs on port 3000, admin on port 3002)
pnpm --filter web dev
pnpm --filter admin dev

# Build all apps
pnpm build

# Lint all packages
pnpm lint

# Format code
pnpm format

# Type check
pnpm typecheck

Project Structure

project-zucchini/
├── apps/
│   ├── admin/          # Admin dashboard (Next.js)
│   ├── mobile/         # Mobile app (Flutter - Coming Soon)
│   └── web/            # Main website (Next.js)
├── packages/
│   ├── eslint-config/  # Shared ESLint configs
│   ├── firebase-config/# Firebase configuration
│   ├── shared-types/   # Shared TypeScript types
│   ├── typescript-config/ # Shared TypeScript configs
│   └── ui/             # Shared UI components
└── turbo.json          # Turborepo configuration

License

Distributed under the MIT License. See LICENSE for more information.

DSC NIT Rourkela

Starware

dscnitrourkela/project-zucchini is Starware. This means you're free to use the project, as long as you star its GitHub repository. Your appreciation makes us grow and glow up. ⭐

Contributors ✨

Thanks goes to these wonderful people (emoji key):

Ayush 💻 📖

This project follows the all-contributors specification. Contributions of any kind welcome!