Skip to content

Repository files navigation

🎓 Campus Utility & Student Toolkit

A 100% static, client-side in-browser student toolkit built with Next.js (App Router), TypeScript, Tailwind CSS, and Lucide React.

Campus Toolkit Overview TypeScript Tailwind CSS Zero Backend


⚡ Key Features & Mini-Tools

  1. 📚 Attendance Goal Calculator: Input present & total classes alongside target quota percentage (default 75%). Computes real-time classes needed or leeway remaining.
  2. 🎓 GPA / CGPA Calculator: Interactive course table with add/remove rows, credit weightage, and instant quality point average calculation.
  3. 🔄 JSON / CSV Text Converter: Dual side-by-side textareas for instant two-way client-side conversion with one-click clipboard copying.
  4. ⏱️ Offline Pomodoro Study Timer: Customizable focus countdown timer with Web Audio API chime sounds and study task checklist.

🏗️ Architecture Highlights

  • Static Modular Engine: Registered via a single configuration array in src/config/tools.ts.
  • Pure Client-Side State: Preferences, saved course lists, and attendance metrics are persisted locally using browser localStorage.
  • Zero API Routes / Database: Works completely offline after initial load.
  • Workshop Ready: Includes 3 deliberate starter issues for open-source PR workshops.

🛠️ Quick Start

# Clone the repository
git clone https://github.com/Adarsh240-feb/WareHouse-Hub.git
cd WareHouse-Hub

# Install dependencies
npm install

# Run local development server
npm run dev

# Export static production bundle
npm run build

Open http://localhost:3000 to view the application in your browser.


🤝 Contributing & Workshop PRs

See CONTRIBUTING.md for instructions on creating new static tools and solving embedded starter issues.

About

A 100% client-side student productivity toolkit with attendance, GPA, JSON/CSV, and Pomodoro tools — built with Next.js & TypeScript. Includes intentional starter bugs for open-source workshop contributors.

Resources

Contributing

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages