Skip to content

Shubham-cyber-prog/StudentVerse-UI

Repository files navigation


Typing SVG


Stars Forks Issues PRs Welcome MIT License Contributions Open


πŸ“– About Β β€’Β  ✨ Features Β β€’Β  πŸš€ Get Started Β β€’Β  🀝 Contribute Β β€’Β  πŸ› οΈ Tools Β β€’Β  πŸ† Contributors


πŸ“– About

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.

🎯 Our Mission

"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


✨ Features

🎨 UI Components Gallery

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

πŸ› οΈ Student Tools

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

πŸ” Search & Filter System

  • 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

🀝 Contribution System

  • 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

πŸ† Gamification (Upcoming)

  • 🌟 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

πŸ› οΈ Tech Stack

Layer Technology
βš›οΈ Framework React 18 + TypeScript
⚑ Build Tool Vite 5
🎨 Styling Tailwind CSS v3
🧩 UI Components shadcn/ui
πŸ§ͺ Testing Vitest
🌐 Deployment Lovable / Vercel

πŸ“ Project Structure

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

πŸš€ Getting Started

Prerequisites

Make sure you have these ready:

Tool Version
Node.js v18 or above
npm / bun Latest
Git Latest

Local Setup

1. Fork & Clone the repo

# Fork first (top-right Fork button), then:
git clone https://github.com/YOUR_USERNAME/studentverse-ui.git
cd studentverse-ui

2. Install dependencies

npm install
# or
bun install

3. Start the development server

npm run dev
# or
bun dev

4. Open in browser

http://localhost:5173

You're up and running! πŸŽ‰


Available Scripts

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 Prettier

🀝 How to Contribute

StudentVerse UI is built for contributors. Whether you're adding a new button style or building a full student tool β€” every contribution matters! πŸ’œ

Ways to Contribute

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

πŸ”€ Contribution Steps

# 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 πŸš€

🎨 Submitting a UI Component

To add a new component to the gallery:

  1. Create your component file inside src/components/gallery/
  2. Add a live preview using React
  3. Include a clean code snippet (copyable)
  4. 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...`
}
  1. Submit your PR β€” that's it! Your name goes on the card forever. πŸ…

🏷️ Issue Labels

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

✍️ Commit Convention

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

🌍 Open Source Programs

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!


πŸ“Š Repo Stats

Commit Activity Last Commit Repo Size Contributors


πŸ† Contributors Hall of Fame

Every component, every fix, every PR β€” it all matters. Thank you! πŸ’œ



Don't see your face here? Make your first contribution now!


πŸ—ΊοΈ Roadmap

βœ… 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

❓ FAQ

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!

πŸ“„ License

This project is licensed under the MIT License β€” free to use, modify, and distribute.

See LICENSE for full details.



🌟 Like what you see? Give us a star β€” it helps more students find this project!


⭐ Star  β†’  More visibility  β†’  More contributors  β†’  Better components for everyone

Made with πŸ’œ by the StudentVerse UI Community

Students building for students β€” one component at a time.


About

StudentVerse UI is an open-source, student-driven platform where learners create, share, and explore reusable UI components and mini tools. Ideal for beginners, college projects, and open-source contributions

Topics

Resources

Contributing

Stars

Watchers

Forks

Packages

 
 
 

Contributors

Languages