{"id":29475397,"url":"https://github.com/adilkadivala/my-uni","last_synced_at":"2026-04-05T21:03:52.169Z","repository":{"id":304521814,"uuid":"1015100718","full_name":"adilkadivala/my-uni","owner":"adilkadivala","description":"Myuni is a Port for student and faculty of University of Macedonia, t was designed to facilitate students' daily interactions with the university.","archived":false,"fork":false,"pushed_at":"2025-07-13T17:11:07.000Z","size":77,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"master","last_synced_at":"2025-07-13T17:38:16.650Z","etag":null,"topics":["docker","express","nginx","react","typescript"],"latest_commit_sha":null,"homepage":"","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/adilkadivala.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2025-07-07T02:23:55.000Z","updated_at":"2025-07-13T17:11:11.000Z","dependencies_parsed_at":"2025-07-13T17:38:20.218Z","dependency_job_id":"f1734a45-ac29-44d8-98e3-55998a17e8e0","html_url":"https://github.com/adilkadivala/my-uni","commit_stats":null,"previous_names":["adilkadivala/my-uni"],"tags_count":null,"template":false,"template_full_name":null,"purl":"pkg:github/adilkadivala/my-uni","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/adilkadivala%2Fmy-uni","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/adilkadivala%2Fmy-uni/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/adilkadivala%2Fmy-uni/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/adilkadivala%2Fmy-uni/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/adilkadivala","download_url":"https://codeload.github.com/adilkadivala/my-uni/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/adilkadivala%2Fmy-uni/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":265314873,"owners_count":23745365,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["docker","express","nginx","react","typescript"],"created_at":"2025-07-14T16:08:44.752Z","updated_at":"2025-12-30T22:07:36.393Z","avatar_url":"https://github.com/adilkadivala.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# 🎓 MyUni - University Management System\n\n\u003cdiv align=\"center\"\u003e\n  \u003cimg src=\"./client/public/logo.svg\" alt=\"MyUni Logo\" width=\"100\" height=\"100\" /\u003e\n\n  \u003ch3\u003e\u003cstrong\u003eA comprehensive university management system built with React + Vite\u003c/strong\u003e\u003c/h3\u003e\n\n  \u003cp\u003e\n    \u003ca href=\"https://react.dev/\"\u003e\u003cimg src=\"https://img.shields.io/badge/React-18-61dafb?style=flat-square\u0026logo=react\" /\u003e\u003c/a\u003e\n    \u003ca href=\"https://vitejs.dev/\"\u003e\u003cimg src=\"https://img.shields.io/badge/Vite-5.0-646CFF?style=flat-square\u0026logo=vite\" /\u003e\u003c/a\u003e\n    \u003ca href=\"https://www.typescriptlang.org/\"\u003e\u003cimg src=\"https://img.shields.io/badge/TypeScript-5.0-blue?style=flat-square\u0026logo=typescript\" /\u003e\u003c/a\u003e\n    \u003ca href=\"https://tailwindcss.com/\"\u003e\u003cimg src=\"https://img.shields.io/badge/TailwindCSS-4.0-38B2AC?style=flat-square\u0026logo=tailwind-css\" /\u003e\u003c/a\u003e\n    \u003ca href=\"https://ui.shadcn.com/\"\u003e\u003cimg src=\"https://img.shields.io/badge/shadcn%2Fui-Latest-000000?style=flat-square\" /\u003e\u003c/a\u003e\n  \u003c/p\u003e\n\u003c/div\u003e\n\n---\n\n## 📖 About MyUni\n\n**MyUni** is a modern, feature-rich university management system designed for students and administrators. Built with the latest frontend technologies, it offers intuitive dashboards, real-time updates, and seamless navigation across multiple university modules.\n\n---\n\n## ✨ Features\n\n- 🎯 **Role-Based Access** — Separate dashboards for Students \u0026 Admins\n- 📅 **Course Scheduling** — Semester plans, subject lists, timings\n- 📢 **Announcements System** — Centralized real-time updates\n- 🍽️ **Campus Services** — Library, restaurant, map, and utilities\n- 👥 **Faculty Directory** — Staff and department listings\n- 🌙 **Dark Mode** — Theme toggle using `shadcn/ui`\n- 📱 **Fully Responsive** — Tailwind-powered mobile-first design\n\n---\n\n## 🚀 Getting Started\n\n### 📦 Prerequisites\n\n- Node.js v18+\n- npm or pnpm or yarn\n\n### 🛠️ Setup\n\n```bash\n# 1. Clone the repo\ngit clone https://github.com/your-username/myuni.git\ncd myuni\n\n# 2. Install dependencies\nnpm install\n\n# 3. Start the dev server\nnpm run dev\n```\n\nVisit: [http://localhost:5173](http://localhost:5173)\n\n---\n\n## 🧪 Default Credentials (For Testing, under development)\n\n### 👨‍🎓 Student\n\n- Email: `student@myuni.edu`\n- Password: `student123`\n\n### 👨‍💼 Admin\n\n- Email: `admin@myuni.edu`\n- Password: `admin123`\n\n---\n\n## 📁 Project Structure (React + Vite)\n\n```txt\nmyuni/\n├── public/                   # Static assets\n├── src/\n│   ├── assets/              # Logos, images, fonts\n│   ├── components/          # Reusable components (shadcn/ui + custom)\n│   ├── layouts/             # Sidebar layout, theme provider, etc.\n│   ├── pages/               # Page components (Dashboard, Services, etc.)\n│   ├── routes/              # React Router routes\n│   ├── context/             # Auth, Theme, and other contexts\n│   ├── hooks/               # Custom hooks\n│   ├── lib/                 # Utility functions\n│   ├── App.tsx             # Main entry point\n│   └── main.tsx            # Vite bootstrap\n├── tailwind.config.ts       # Tailwind config\n├── postcss.config.js        # PostCSS config\n├── tsconfig.json            # TypeScript config\n├── index.html               # HTML entry\n└── vite.config.ts           # Vite config\n```\n\n---\n\n## 💻 Tech Stack\n\n| Tool                | Description                         |\n| ------------------- | ----------------------------------- |\n| **React 18**        | UI Library                          |\n| **Vite 5+**         | Fast build tool and dev server      |\n| **TypeScript**      | Static typing                       |\n| **Tailwind CSS v4** | Utility-first CSS framework         |\n| **shadcn/ui**       | Beautiful component library         |\n| **Lucide**          | Icon set used in UI                 |\n| **React Router**    | Routing between student/admin pages |\n\n---\n\n## 🔐 Authentication\n\n- Basic login authentication (username/password)\n- Role-based access (admin, student)\n- Protected routes (via context or middleware)\n\n---\n\n## 🌙 Theme \u0026 Styling\n\n- Theme toggle (light/dark) via `shadcn/ui`\n- Typography: `Inter`, imported via Google Fonts\n- Fully responsive using Tailwind's mobile-first utilities\n\n---\n\n## 🧑‍💻 Contributing\n\n```bash\n# Create a new feature branch\ngit checkout -b feature/awesome-feature\n\n# Make your changes, then push:\ngit push origin feature/awesome-feature\n```\n\nThen open a **Pull Request**!\n\n### Guidelines\n\n- Type-safe code (TypeScript)\n- Use Tailwind for styling\n- Follow component conventions (`shadcn/ui`)\n- Keep code readable and modular\n\n---\n\n## 📄 License\n\nThis project is licensed under the **MIT License**. See [LICENSE](./LICENSE) for more info.\n\n---\n\n\u003cdiv align=\"center\"\u003e\n  \u003cstrong\u003eMade with ❤️ \u003c/strong\u003e\u003cbr/\u003e\n  © 2025 MyUni. All rights reserved.\n\u003c/div\u003e\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fadilkadivala%2Fmy-uni","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fadilkadivala%2Fmy-uni","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fadilkadivala%2Fmy-uni/lists"}