π About Β β’Β β¨ Features Β β’Β π Get Started Β β’Β π€ Contribute Β β’Β π οΈ Tools Β β’Β π Contributors
StudentVerse UI is a community-driven, open-source platform where students create, share, and explore beautiful UI components and mini tools built for everyday student life.
Inspired by uiverse.io β but made by students, for students.
"Every student has something to build. StudentVerse UI gives them a stage to share it."
- π¦ A growing library of copy-paste ready UI components
- π οΈ Practical student tools β CGPA calc, Pomodoro, planners & more
- π€ A beginner-friendly space for real-world open source experience
- π Ideal for GSSoC, Hacktoberfest, and portfolio building
A curated, ever-growing collection of components β all live-preview enabled and copy-ready.
| Category | Examples |
|---|---|
| π Buttons | Animated, gradient, glowing, 3D, icon buttons |
| π Cards | Profile cards, pricing cards, glassmorphism cards |
| π Forms | Login, signup, OTP, floating label inputs |
| π Navbars | Sticky, hamburger, sidebar, glassmorphism |
| β³ Loaders | Spinners, skeleton, progress bars, dots |
| πͺ Modals | Popup dialogs, confirmation boxes, drawers |
| π·οΈ Badges & Tags | Status chips, notification badges |
| π Carousels | Image sliders, testimonial carousels |
β Each component comes with:
- Live interactive preview
- Clean, copy-ready code snippet (HTML/CSS/JS or React/Tailwind)
- Tech tags β HTML Β· CSS Β· JavaScript Β· Tailwind Β· Bootstrap
- Difficulty label β Beginner / Intermediate / Advanced
- Contributor name + GitHub profile link
Real tools that students actually use β no bloat, just utility.
| Tool | Description |
|---|---|
| π CGPA Calculator | Calculate SGPA & CGPA with grade inputs |
| π Attendance Tracker | Track class-wise attendance & get shortage alerts |
| π Pomodoro Timer | Focus timer with customizable work/break cycles |
| β To-Do / Study Planner | Manage tasks with priority, deadlines & status |
| π Resume Builder | Generate a clean ATS-friendly resume with live preview |
- Filter components by category β Buttons, Cards, Modals, etc.
- Filter by tech stack β HTML, Tailwind, React, Bootstrap
- Filter by difficulty β Beginner / Intermediate
- Keyword search to find exactly what you need
- Submit your own components with live preview support
- Your GitHub profile + name shown on every component you submit
- Beginner-friendly issue structure for guided contributions
- Each PR reviewed and merged with credit
- π Contributor XP Points β earn points per accepted contribution
- π Badges β First PR, Top Contributor, Component Master, Tool Builder
- π Leaderboard β see the most active contributors
- π― Seasonal contribution challenges & rewards
| Layer | Technology |
|---|---|
| βοΈ Framework | React 18 + TypeScript |
| β‘ Build Tool | Vite 5 |
| π¨ Styling | Tailwind CSS v3 |
| π§© UI Components | shadcn/ui |
| π§ͺ Testing | Vitest |
| π Deployment | Lovable / Vercel |
studentverse-ui/
β
βββ π public/ # Favicon & static assets
β
βββ π src/
β βββ π components/
β β βββ π ui/ # shadcn/ui base components
β β βββ π layout/ # Navbar, Footer, Sidebar
β β βββ π gallery/ # Component cards, preview, code viewer
β β βββ π tools/ # Student tools (CGPA, Pomodoro, etc.)
β β βββ π submission/ # Component submission form & preview
β β βββ π shared/ # Search bar, Filters, Badges, Tags
β β
β βββ π pages/
β β βββ HomePage.tsx # Landing page with highlights
β β βββ GalleryPage.tsx # Full component gallery
β β βββ ComponentDetailPage.tsx # Single component preview + code
β β βββ ToolsPage.tsx # Student tools listing
β β βββ SubmitPage.tsx # Submit your component
β β βββ ContributorsPage.tsx # Hall of Fame
β β
β βββ π data/
β β βββ components.ts # All component metadata & code
β β βββ tools.ts # Student tools metadata
β β
β βββ π hooks/ # Custom hooks (useSearch, useFilter)
β βββ π lib/ # Utility functions
β βββ π types/ # TypeScript interfaces
β βββ App.tsx
β βββ main.tsx
β
βββ CONTRIBUTING.md
βββ index.html
βββ tailwind.config.ts
βββ vite.config.ts
βββ package.json
Make sure you have these ready:
| Tool | Version |
|---|---|
| Node.js | v18 or above |
| npm / bun | Latest |
| Git | Latest |
1. Fork & Clone the repo
# Fork first (top-right Fork button), then:
git clone https://github.com/YOUR_USERNAME/studentverse-ui.git
cd studentverse-ui2. Install dependencies
npm install
# or
bun install3. Start the development server
npm run dev
# or
bun dev4. Open in browser
http://localhost:5173
You're up and running! π
npm run dev # Start dev server
npm run build # Build for production
npm run preview # Preview production build
npm run lint # Run ESLint checks
npm run test # Run tests with Vitest
npm run format # Format code with PrettierStudentVerse UI is built for contributors. Whether you're adding a new button style or building a full student tool β every contribution matters! π
| Type | Description |
|---|---|
| π¨ Add a UI Component | Submit a new button, card, modal, navbar, etc. |
| π οΈ Build a Student Tool | Add a useful tool for student daily life |
| π Fix a Bug | Find & fix issues in existing code |
| π Improve Docs | Fix typos, add explanations, improve guides |
| π‘ Suggest Features | Open an issue with your idea |
| π§ͺ Write Tests | Add Vitest unit/integration tests |
# Step 1: Fork this repo & clone your fork
git clone https://github.com/YOUR_USERNAME/studentverse-ui.git
# Step 2: Create a new branch
git checkout -b feat/your-component-name
# Step 3: Make your changes (see guidelines below)
# Step 4: Commit your work
git add .
git commit -m "feat: add glassmorphism login card"
# Step 5: Push to your fork
git push origin feat/your-component-name
# Step 6: Open a Pull Request on GitHub πTo add a new component to the gallery:
- Create your component file inside
src/components/gallery/ - Add a live preview using React
- Include a clean code snippet (copyable)
- Add metadata to
src/data/components.ts:
{
id: "glassmorphism-card",
title: "Glassmorphism Card",
category: "Cards",
tags: ["CSS", "HTML"],
difficulty: "Beginner",
contributor: {
name: "Your Name",
github: "https://github.com/yourusername"
},
preview: GlassmorphismCard, // React component
code: `...your HTML/CSS here...`
}- Submit your PR β that's it! Your name goes on the card forever. π
| Label | Meaning | Best For |
|---|---|---|
good first issue |
Simple, guided tasks | π’ New contributors |
help wanted |
Needs community input | π‘ Anyone |
new component |
Add a UI component | π’ All levels |
new tool |
Build a student tool | π‘ Intermediate |
bug |
Something is broken | π‘ Intermediate |
documentation |
Improve README/guides | π’ Beginners |
enhancement |
Improve existing feature | π Any level |
We use Conventional Commits:
feat: β¨ New component or tool
fix: π Bug fix
docs: π Documentation update
style: π CSS / UI-only change
refactor: β»οΈ Code cleanup, no feature change
test: π§ͺ Tests added
chore: π§ Config, build changes
StudentVerse UI is open for contributions through:
| Program | Status |
|---|---|
| πΈ GSSoC β GirlScript Summer of Code | β Participating |
| π Hacktoberfest | β Participating |
| π SSOC β Social Summer of Code | π Upcoming |
| βοΈ JWOC β JGEC Winter of Code | π Upcoming |
π‘ Contributing here counts toward your open-source program goals AND gives you real portfolio experience!
Every component, every fix, every PR β it all matters. Thank you! π
Don't see your face here? Make your first contribution now!
β
Phase 1 β Foundation
βββ β
Project setup (React + Vite + Tailwind + shadcn/ui)
βββ β
Component gallery with live preview
βββ β
Copy-ready code snippets
βββ β
Basic student tools
π Phase 2 β Community Growth (In Progress)
βββ π Component submission system
βββ π Search & advanced filters
βββ π More student tools (Resume Builder, Attendance Tracker)
βββ π Contributor credits on all components
π Phase 3 β Platform Polish
βββ π Dark/light mode toggle
βββ π Improved component preview sandbox
βββ π Component versioning & update history
βββ π Mobile-responsive improvements
π Phase 4 β Gamification
βββ π Contributor XP & badge system
βββ π Monthly leaderboard
βββ π Seasonal contribution challenges
βββ π Institutional contributor rankings
Who can contribute to StudentVerse UI?
Anyone! Whether you're a complete beginner learning HTML/CSS or an experienced React developer β there's always something for you here. We have issues labeled
good first issue specifically for new contributors.
What kind of components can I submit?
Any reusable UI component β buttons, cards, navbars, modals, loaders, forms, tooltips, badges, and more. Make sure it's original, visually appealing, and has clean code. Both HTML/CSS and React/Tailwind submissions are welcome!
Will my name be shown on my contribution?
Yes! Every component you submit will display your name and link to your GitHub profile. Your contribution lives forever in the gallery and in the contributors section.
Does this count for GSSoC / Hacktoberfest?
Yes! StudentVerse UI participates in GSSoC and Hacktoberfest. Contributions here count toward your program goals. Watch our repo and Discord for program-specific updates.
I found a bug. How do I report it?
Open a GitHub Issue using the Bug Report template. Describe the problem, steps to reproduce, and screenshots if possible. We respond within 48 hours!
This project is licensed under the MIT License β free to use, modify, and distribute.
See LICENSE for full details.
