{"id":29966224,"url":"https://github.com/ctoic/campushive-frontend","last_synced_at":"2026-04-17T06:33:45.389Z","repository":{"id":291366267,"uuid":"977406228","full_name":"Ctoic/CampusHive-Frontend","owner":"Ctoic","description":"Multiagent system for University","archived":false,"fork":false,"pushed_at":"2026-03-12T09:15:58.000Z","size":25754,"stargazers_count":0,"open_issues_count":2,"forks_count":0,"subscribers_count":1,"default_branch":"master","last_synced_at":"2026-03-12T16:09:09.835Z","etag":null,"topics":["chatbotui","fyp","hacktoberfest","hacktoberfest-accepted","html","react","reactchatbot"],"latest_commit_sha":null,"homepage":"https://campushiveassist.netlify.app/","language":"JavaScript","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/Ctoic.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,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2025-05-04T06:09:22.000Z","updated_at":"2026-03-12T09:16:03.000Z","dependencies_parsed_at":"2025-08-04T02:35:31.293Z","dependency_job_id":"5e73b21b-914b-4660-b1f9-b9d9bffe337f","html_url":"https://github.com/Ctoic/CampusHive-Frontend","commit_stats":null,"previous_names":["ctoic/campushive-frontend"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/Ctoic/CampusHive-Frontend","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Ctoic%2FCampusHive-Frontend","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Ctoic%2FCampusHive-Frontend/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Ctoic%2FCampusHive-Frontend/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Ctoic%2FCampusHive-Frontend/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Ctoic","download_url":"https://codeload.github.com/Ctoic/CampusHive-Frontend/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Ctoic%2FCampusHive-Frontend/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":31918619,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-16T18:22:33.417Z","status":"online","status_checked_at":"2026-04-17T02:00:06.879Z","response_time":62,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"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":["chatbotui","fyp","hacktoberfest","hacktoberfest-accepted","html","react","reactchatbot"],"created_at":"2025-08-04T02:31:33.037Z","updated_at":"2026-04-17T06:33:45.372Z","avatar_url":"https://github.com/Ctoic.png","language":"JavaScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# 🎓 CampusHive Frontend\n\n\n  \n  **An Intelligent AI-Powered Academic Assistant Platform**\n  \n  [![React](https://img.shields.io/badge/React-18.3.1-blue.svg)](https://reactjs.org/)\n  [![Vite](https://img.shields.io/badge/Vite-5.4.2-646CFF.svg)](https://vitejs.dev/)\n  [![Tailwind CSS](https://img.shields.io/badge/Tailwind%20CSS-3.4.1-38B2AC.svg)](https://tailwindcss.com/)\n  [![TypeScript](https://img.shields.io/badge/TypeScript-5.0+-blue.svg)](https://www.typescriptlang.org/)\n\u003c/div\u003e\n\n## 🌟 Overview\n\nCampusHive Frontend is a modern, responsive web application built with React and Vite that provides an intelligent AI-powered academic assistant platform. It features a sophisticated chatbot interface, comprehensive admin dashboard, and beautiful user experience designed for students, faculty, and administrators.\n\n## ✨ Key Features\n\n### 🤖 **Intelligent Chatbot Interface**\n- **Multi-Agent AI System**: Advanced conversational AI with specialized agents for different academic domains\n- **Session Management**: Persistent chat sessions with history and context preservation\n- **Real-time Communication**: Instant responses with streaming capabilities\n- **Markdown Support**: Rich text rendering with code blocks, tables, and formatting\n- **Quick Actions**: Pre-defined action buttons for common academic queries\n\n### 👨‍💼 **Admin Dashboard**\n- **System Monitoring**: Real-time health monitoring and system statistics\n- **User Management**: Comprehensive user administration and role management\n- **Vector Store Management**: AI knowledge base administration and maintenance\n- **Exam Upload System**: Bulk exam document processing and management\n- **System Information**: Detailed system metrics and performance monitoring\n\n### 🎨 **Modern UI/UX**\n- **Responsive Design**: Mobile-first approach with seamless cross-device experience\n- **Dark Theme**: Beautiful dark mode with custom color schemes\n- **Interactive Components**: Smooth animations and transitions using Framer Motion\n- **Accessibility**: WCAG compliant with keyboard navigation and screen reader support\n- **Component Library**: Custom UI components built with Radix UI and Tailwind CSS\n\n### 🔐 **Authentication \u0026 Security**\n- **JWT Authentication**: Secure token-based authentication system\n- **Role-Based Access Control**: Different access levels for students, faculty, and admins\n- **Protected Routes**: Secure navigation with authentication guards\n- **Session Management**: Automatic token refresh and logout handling\n\n## 🖼️ Screenshots\n\n### Landing Page \u0026 Authentication\n\u003cdiv align=\"center\"\u003e\n  \u003cimg src=\"screenshots/hero.png\" alt=\"Hero Section\" width=\"800\"\u003e\n  \u003cp\u003e\u003cem\u003eBeautiful hero section with modern design and interactive elements\u003c/em\u003e\u003c/p\u003e\n\u003c/div\u003e\n\n\u003cdiv align=\"center\"\u003e\n  \u003cimg src=\"screenshots/login.png\" alt=\"Login Page\" width=\"800\"\u003e\n  \u003cp\u003e\u003cem\u003eSecure login interface with elegant design\u003c/em\u003e\u003c/p\u003e\n\u003c/div\u003e\n\n\u003cdiv align=\"center\"\u003e\n  \u003cimg src=\"screenshots/signup.png\" alt=\"Signup Page\" width=\"800\"\u003e\n  \u003cp\u003e\u003cem\u003eUser registration with form validation and security\u003c/em\u003e\u003c/p\u003e\n\u003c/div\u003e\n\n\u003cdiv align=\"center\"\u003e\n  \u003cimg src=\"screenshots/why.png\" alt=\"Why Choose CampusHive\" width=\"800\"\u003e\n  \u003cp\u003e\u003cem\u003eFeature showcase highlighting platform benefits\u003c/em\u003e\u003c/p\u003e\n\u003c/div\u003e\n\n### Chatbot Interface\n\u003cdiv align=\"center\"\u003e\n  \u003cimg src=\"screenshots/chatbot.png\" alt=\"Chatbot Interface\" width=\"800\"\u003e\n  \u003cp\u003e\u003cem\u003eIntelligent chatbot with session management and quick actions\u003c/em\u003e\u003c/p\u003e\n\u003c/div\u003e\n\n### Admin Dashboard\n\u003cdiv align=\"center\"\u003e\n  \u003cimg src=\"screenshots/admin.png\" alt=\"Admin Dashboard Overview\" width=\"800\"\u003e\n  \u003cp\u003e\u003cem\u003eComprehensive admin dashboard with system overview and navigation\u003c/em\u003e\u003c/p\u003e\n\u003c/div\u003e\n\n\u003cdiv align=\"center\"\u003e\n  \u003cimg src=\"screenshots/users.png\" alt=\"User Management\" width=\"800\"\u003e\n  \u003cp\u003e\u003cem\u003eUser management interface with role-based controls and administration\u003c/em\u003e\u003c/p\u003e\n\u003c/div\u003e\n\n\u003cdiv align=\"center\"\u003e\n  \u003cimg src=\"screenshots/health.png\" alt=\"System Health Monitor\" width=\"800\"\u003e\n  \u003cp\u003e\u003cem\u003eReal-time system health monitoring and performance diagnostics\u003c/em\u003e\u003c/p\u003e\n\u003c/div\u003e\n\n## 🛠️ Technology Stack\n\n### **Frontend Framework**\n- **React 18.3.1** - Modern React with hooks and concurrent features\n- **Vite 5.4.2** - Lightning-fast build tool and development server\n- **React Router DOM 6.22.1** - Client-side routing and navigation\n\n### **UI \u0026 Styling**\n- **Tailwind CSS 3.4.1** - Utility-first CSS framework\n- **Radix UI** - Accessible, unstyled UI components\n- **Framer Motion 11.18.2** - Production-ready motion library\n- **Lucide React** - Beautiful, customizable icons\n- **React Icons** - Popular icon libraries\n\n### **Form Handling \u0026 Validation**\n- **React Hook Form 7.58.0** - Performant forms with easy validation\n- **Zod 3.25.64** - TypeScript-first schema validation\n- **@hookform/resolvers** - Validation resolvers for React Hook Form\n\n### **Content \u0026 Markdown**\n- **React Markdown 10.1.0** - Markdown component for React\n- **Remark GFM** - GitHub Flavored Markdown support\n\n### **Development Tools**\n- **ESLint** - Code linting and quality assurance\n- **TypeScript** - Static type checking\n- **PostCSS** - CSS processing and optimization\n- **Autoprefixer** - CSS vendor prefixing\n\n## 🚀 Quick Start\n\n### Prerequisites\n- **Node.js** (v18 or higher)\n- **npm** or **yarn**\n- **CampusHive Backend** running on `http://localhost:8000`\n\n### Installation\n\n1. **Clone the repository**\n   ```bash\n   git clone https://github.com/yourusername/campus-hive.git\n   cd campus-hive/CampusHive-Frontend\n   ```\n\n2. **Install dependencies**\n   ```bash\n   npm install\n   # or\n   yarn install\n   ```\n\n3. **Set up environment variables**\n   ```bash\n   cp .env.example .env\n   ```\n   \n   Configure your environment variables:\n   ```env\n   VITE_API_BASE_URL=http://localhost:8000\n   VITE_APP_NAME=CampusHive\n   ```\n\n4. **Start the development server**\n   ```bash\n   npm run dev\n   # or\n   yarn dev\n   ```\n\n5. **Open your browser**\n   Navigate to `http://localhost:5173` to view the application.\n\n## 📁 Project Structure\n\n```\nCampusHive-Frontend/\n├── public/                 # Static assets\n├── src/\n│   ├── assets/            # Images, icons, and static files\n│   ├── components/        # Reusable React components\n│   │   ├── admin/         # Admin-specific components\n│   │   ├── blocks/        # UI block components\n│   │   ├── hooks/         # Custom React hooks\n│   │   └── ui/            # Base UI components\n│   ├── contexts/          # React context providers\n│   ├── lib/               # Utility libraries and API client\n│   ├── pages/             # Page components\n│   ├── utils/             # Helper functions\n│   ├── App.jsx            # Main application component\n│   └── main.jsx           # Application entry point\n├── screenshots/           # Application screenshots\n├── docs/                  # Documentation\n├── package.json           # Dependencies and scripts\n├── tailwind.config.cjs    # Tailwind CSS configuration\n├── vite.config.js         # Vite configuration\n└── README.md              # This file\n```\n\n## 🎯 Available Scripts\n\n```bash\n# Development\nnpm run dev          # Start development server\nnpm run build        # Build for production\nnpm run preview      # Preview production build\nnpm run lint         # Run ESLint\n\n# Production\nnpm run build        # Create optimized production build\n```\n\n## 🔧 Configuration\n\n### Environment Variables\n\nCreate a `.env` file in the root directory:\n\n```env\n# API Configuration\nVITE_API_BASE_URL=http://localhost:8000\nVITE_APP_NAME=CampusHive\nVITE_APP_VERSION=1.0.0\n\n# Feature Flags\nVITE_ENABLE_ANALYTICS=false\nVITE_ENABLE_DEBUG_MODE=false\n```\n\n### Tailwind CSS Configuration\n\nThe project uses a custom Tailwind configuration with:\n- Custom color palette\n- Extended spacing and typography\n- Animation utilities\n- Component-specific styles\n\n## 🎨 UI Components\n\n### **Core Components**\n- **Navbar** - Responsive navigation with authentication\n- **Hero** - Landing page hero section\n- **Chatbot** - AI conversation interface\n- **AdminDashboard** - Administrative control panel\n- **ProtectedRoute** - Authentication guards\n\n### **Admin Components**\n- **UserManagement** - User administration\n- **VectorStoresManagement** - AI knowledge base management\n- **ExamUpload** - Document processing system\n- **SystemInfo** - System monitoring\n- **HealthMonitor** - Real-time health checks\n\n### **UI Components**\n- **Button** - Customizable button component\n- **Card** - Content container component\n- **Dialog** - Modal and overlay components\n- **Input** - Form input components\n- **Table** - Data display component\n\n## 🔐 Authentication Flow\n\n1. **User Registration/Login** - Secure authentication with JWT tokens\n2. **Role-Based Access** - Different interfaces for students, faculty, and admins\n3. **Protected Routes** - Automatic redirection for unauthorized access\n4. **Session Management** - Persistent login state with automatic refresh\n\n## 📱 Responsive Design\n\nThe application is fully responsive with breakpoints:\n- **Mobile**: \u003c 768px\n- **Tablet**: 768px - 1024px\n- **Desktop**: \u003e 1024px\n\n## 🚀 Deployment\n\n### Build for Production\n\n```bash\nnpm run build\n```\n\nThis creates an optimized build in the `dist/` directory.\n\n### Deploy to Vercel\n\n```bash\n# Install Vercel CLI\nnpm i -g vercel\n\n# Deploy\nvercel --prod\n```\n\n### Deploy to Netlify\n\n```bash\n# Build the project\nnpm run build\n\n# Deploy dist/ folder to Netlify\n```\n\n## 🤝 Contributing\n\nWe welcome contributions! Please follow these steps:\n\n1. **Fork the repository**\n2. **Create a feature branch**\n   ```bash\n   git checkout -b feature/amazing-feature\n   ```\n3. **Commit your changes**\n   ```bash\n   git commit -m 'Add amazing feature'\n   ```\n4. **Push to the branch**\n   ```bash\n   git push origin feature/amazing-feature\n   ```\n5. **Open a Pull Request**\n\n### Development Guidelines\n\n- Follow the existing code style and conventions\n- Write meaningful commit messages\n- Add tests for new features\n- Update documentation as needed\n- Ensure all tests pass before submitting\n\n## 📚 Documentation\n\n- [API Documentation](../docs/api/README.md)\n- [Component Documentation](./docs/components.md)\n- [Deployment Guide](./docs/deployment.md)\n- [Contributing Guidelines](./docs/contributing.md)\n\n## 🐛 Troubleshooting\n\n### Common Issues\n\n**Build Errors**\n```bash\n# Clear node_modules and reinstall\nrm -rf node_modules package-lock.json\nnpm install\n```\n\n**API Connection Issues**\n- Verify backend server is running on `http://localhost:8000`\n- Check environment variables in `.env` file\n- Ensure CORS is properly configured\n\n**Authentication Issues**\n- Clear browser storage and cookies\n- Verify JWT token configuration\n- Check user role permissions\n\n## 📄 License\n\nThis project is licensed under the MIT License - see the [LICENSE](../LICENSE) file for details.\n\n## 🙏 Acknowledgments\n\n- **React Team** - For the amazing framework\n- **Vite Team** - For the lightning-fast build tool\n- **Tailwind CSS** - For the utility-first CSS framework\n- **Radix UI** - For accessible component primitives\n- **Framer Motion** - For smooth animations\n\n## 📞 Support\n\n- **Email**: support@campushive.com\n- **Documentation**: [docs.campushive.com](https://docs.campushive.com)\n- **Issues**: [GitHub Issues](https://github.com/yourusername/campus-hive/issues)\n\n---\n\n\u003cdiv align=\"center\"\u003e\n  \u003cp\u003eMade with ❤️ by the CampusHive Team\u003c/p\u003e\n  \u003cp\u003e© 2025 CampusHive. All rights reserved.\u003c/p\u003e\n\u003c/div\u003e\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fctoic%2Fcampushive-frontend","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fctoic%2Fcampushive-frontend","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fctoic%2Fcampushive-frontend/lists"}