🤖 IEEE RAS ENIS Student Branch Website

Innovating the Future, One Line of Code at a Time.

---

📖 Overview

A premium, high-performance web application built for the IEEE Robotics & Automation Society (RAS) Student Branch at ENIS. This platform serves as a central hub for members and the community to explore projects, events, news, and more. It features a modern glassmorphism design with high-fidelity animations and interactive 3D elements.

✨ Key Features

• 🚀 Cinematic Experience: High-fidelity animations powered by GSAP and ScrollTrigger for a professional, immersive feel.
• 🎨 Premium UX/UI: Modern glassmorphism design with smooth transitions and Framer Motion interactions.
• 🕶️ 3D Integration: Features interactive 3D scenes integrated via Spline.
• 🛡️ Secure Dashboard: Role-based access control for members and administrators to manage content via Supabase.
• 🏪 Society Shop: Integrated marketplace for society merchandise and electronics components.
• 📂 Project Showcase: A dynamic gallery of robotics and automation projects developed by the branch.
• 📅 Event Management: Real-time updates on upcoming workshops, competitions, and seminars.
• 🌐 Responsive & Accessible: Optimized for all devices, from mobile to ultra-wide displays.

---

🛠️ Tech Stack

Category	Technology
Framework	React 19 + Vite 7
Styling	Tailwind CSS + Shadcn UI
Animations	GSAP + Framer Motion
Backend	Supabase (PostgreSQL + Auth)
Utilities	Lenis Scroll, Lucide React
3D Engine	Spline
Language	TypeScript

---

📂 Project Structure

app/
├── public/              # Static assets (images, fonts, 3D models)
├── src/
│   ├── components/      # Reusable UI & Layout components
│   ├── sections/        # Main landing page sections
│   ├── hooks/           # Custom React hooks
│   ├── types/           # TypeScript definitions
│   ├── lib/             # Utility functions & Supabase client
│   ├── App.tsx          # Main entry point & Routing
│   └── main.tsx         # React DOM rendering
├── tailwind.config.js   # Custom theme & animation config
└── vite.config.ts       # Vite build & plugin configuration

---

🚀 Getting Started

Prerequisites

• Node.js (v20 or higher)
• npm or yarn
• Supabase Account (for backend features)

Installation

1. Clone the repository:

   git clone <repository-url>
   cd "ras website"

2. Navigate to the app directory:

   cd app

3. Install dependencies:

   npm install

4. Environment Variables: Create a .env.local file in the app directory:

   VITE_SUPABASE_URL=your_supabase_url
   VITE_SUPABASE_ANON_KEY=your_supabase_anon_key

5. Start the development server:

   npm run dev

---

🤝 Contributing

we welcome contributions! Please follow these steps:

1. Fork the repository.
2. Create a new branch (git checkout -b feature/AmazingFeature).
3. Commit your changes (git commit -m 'Add some AmazingFeature').
4. Push to the branch (git push origin feature/AmazingFeature).
5. Open a Pull Request.

---

📜 License

Distributed under the MIT License. See LICENSE for more information.

---

Developed by the webmaster Escgot of the IEEE RAS ENIS.