The official source code for the IEEE MSIT student branch website.
A fully optimized PWA with comprehensive SEO, engineered by the Web Development Department '25.
This platform is engineered with a rich feature set to inform, engage, and inspire.
| Feature | Description |
|---|---|
| Dynamic Content Sections | Data-driven components for Events, Hackathons, Team, and Chapters that are rendered from a single, easy-to-edit data.ts file. |
| Transparent Leadership Profiles | Detailed member cards for the 2025 and 2024 Executive Committees, featuring roles, photos, and direct LinkedIn profile links. |
| Interactive Event Carousels | A sleek, responsive carousel for showcasing upcoming events and workshops, designed for maximum user engagement. |
| Hackathon & Winners Showcase | A dedicated hall of fame celebrating our flagship hackathons, featuring winning teams, innovative projects, and prize details. |
| AI-Powered Intelligent Assistant | An integrated RAG chatbot providing instant, context-aware answers to queries about events, membership, chapters, and more. |
| Feature | Description |
|---|---|
| Progressive Web App | Full PWA support with offline capabilities, app-like experience, and home screen installation. |
| Install Notifications | Smart install prompts for both Android and iOS devices with customized instructions. |
| Service Worker Caching | Intelligent caching strategy for optimal performance and offline functionality. |
| App-like Experience | Native app feel with proper theming, splash screens, and seamless navigation. |
| Feature | Description |
|---|---|
| Comprehensive Meta Tags | Complete SEO optimization with Open Graph, Twitter Cards, and platform-specific meta tags. |
| Schema.org Structured Data | Rich snippets and structured data for better search engine understanding. |
| Multi-Platform OG Images | Optimized social media sharing with custom OG images for different platforms. |
| Performance Monitoring | Core Web Vitals tracking and performance optimization. |
| Sitemap & Robots.txt | Automated sitemap generation and proper SEO directives. |
This project is built on a modern, robust, and efficient technology stack that aligns with our organization's standards.
| Component | Technologies |
|---|---|
| Frontend Framework | React, TypeScript, Vite |
| Styling & UI | Tailwind CSS, Lucide React, react-fast-marquee |
| Routing | React Router DOM |
| AI Integration | 10xanswers (Retrieval-Augmented Generation Chatbot) |
| Code Quality | ESLint, Prettier |
To get a local copy up and running, follow these simple steps. This is essential for any developer looking to contribute.
Ensure you have the following installed on your machine:
Clone the Repository
git clone https://github.com/IEEE-MSIT/website.git cd websiteInstall Dependencies
pnpm install
Run the Development Server
pnpm dev
Open in Browser
The application will now be running and accessible athttp://localhost:5173.
This project operates with a professional development workflow. All contributions, regardless of size, must follow these steps to ensure quality and consistency.
Find an Issue
All work begins with an issue. Browse the Issues tab. If your idea doesn't have an issue, create one using our templates.Fork & Clone
Fork the repository to your personal account and clone it to your local machine.Create a Branch
Create a new branch frommainwith a descriptive name. We follow the[type]/[short-description]convention (e.g.,feat/add-event-carousel,fix/header-alignment).git checkout -b feat/my-new-feature
Develop & Commit
Make your changes. Write clean, well-documented code. Commit your work with clear, conventional commit messages (e.g.,feat: Add user authentication endpoint).Push and Open a Pull Request (PR)
Push your branch to your fork and open a Pull Request against themainbranch of this repository. Provide a detailed description of your changes in the PR.Code Review
Your PR will be reviewed by the Web Dev leadership. Engage in the discussion and make any required changes. At least one approval is required to merge.
Most of the website's content (events, team members, hackathon results) is managed in a single file. This allows for easy updates without needing to run the project locally.
- File to Edit:
src/data/data.ts
To update content, simply edit this file directly on GitHub, commit your changes to a new branch, and open a Pull Request.
Meet the team responsible for architecting and maintaining this platform.
Nithin Chairperson | Anuraj Vice Chairperson |
This project is licensed under the MIT License. See the LICENSE file for more details.