Catalyst | Mar Baselios IEDC

Catalyst — Innovation and Entrepreneurship Development Centre of Mar Baselios College of Engineering and Technology.

Welcome to the official repository for the Catalyst Web Application. This platform serves as the digital hub for the Innovation and Entrepreneurship Development Centre (IEDC) at Mar Baselios College of Engineering and Technology (MBCET).

🚀 Tech Stack

This project is built with modern web technologies to ensure a fast, accessible, and highly interactive user experience.

• Framework: Next.js 16 (App Router, Turbopack)
• Library: React 19
• Styling: Tailwind CSS v4
• UI Components: shadcn/ui & Radix UI
• Animations & Effects:
  • GSAP & Framer Motion
  • Lenis (Smooth Scrolling)
  • Three.js & React Three Fiber (3D Elements)
• Backend/BaaS: Supabase
• State Management: Zustand
• Language: TypeScript

🛠️ Getting Started

Follow these instructions to set up the project locally.

Prerequisites

• Node.js (v18 or higher recommended)
• npm or pnpm

Installation

1. Clone the repository:

   git clone <your-repo-url>
   cd Catalyst-Web

2. Install dependencies:

   npm install

3. Set up environment variables:

   • Copy the .env.example file to .env or .env.local:

     cp .env.example .env.local

   • Fill in the required environment variables in the .env.local file:
     • NEXT_PUBLIC_SUPABASE_URL
     • NEXT_PUBLIC_SUPABASE_ANON_KEY
     • DISCORD_WEBHOOK_URL
     • INTERNAL_API_KEY
     • VERCEL_AUTOMATION_BYPASS_SECRET (if deploying on Vercel)

4. Run the development server:

   npm run dev

   Open http://localhost:3000 in your browser to view the application.

📦 Scripts

• npm run dev: Starts the Next.js development server with Turbopack.
• npm run build: Creates an optimized production build.
• npm run start: Starts the production server.
• npm run lint: Runs ESLint to catch syntax and style issues.

🗂️ Project Structure

• /app: Next.js App Router layout, pages, and API routes.
• /components: Reusable UI components (including shadcn/ui).
• /hooks: Custom React hooks.
• /lib: Utility functions and configuration (e.g., Supabase client).
• /public: Static assets like fonts and images.

📄 License

This project is licensed under the MIT License.