Skip to content

fluxsati/FLUX-FRONTEND

Repository files navigation

⚑ FLUX FRONTEND

A next-generation interactive web experience built with cutting-edge web technologies.

Project Status License

πŸ“– Overview

FLUX FRONTEND is the central hub for the Technical club Flux of SATI, offering an immersive gateway to our Events, Projects, and Learning Hub. A dynamic Team showcase, and a dedicated Group Chat for members, all while serving as the modern successor to our Old Site.

✨ Key Features

  • πŸš€ Blazing Fast: Powered by Vite for instant server start and lightning-fast HMR.
  • 🎨 Stunning Visuals: Integrated Three.js and Vanta.js for rich, interactive backgrounds and 3D elements.
  • ✨ Smooth Animations: Complex sequences orchestrated with GSAP and Framer Motion.
  • 🌊 Fluid Scrolling: Implemented smooth scrolling behavior using Lenis.
  • πŸ“± Fully Responsive: Mobile-first design philosophy using TailwindCSS.
  • πŸ”Œ Modern State Management: Utilizes Redux Toolkit for efficient state handling.

πŸ› οΈ Tech Stack

This project is built using the following technologies:

πŸš€ Getting Started

Follow these steps to set up the project locally.

Prerequisites

Ensure you have the following installed:

  • Node.js (v16+ recommended)
  • npm or yarn

Installation

  1. Clone the repository

    git clone https://github.com/SAFAL-TIWARI/FLUX-FRONTEND.git
    cd FLUX-FRONTEND
  2. Install dependencies

    npm install
  3. Start the development server

    npm run dev

    The application will be available at http://localhost:5173 (or the port shown in your terminal).

πŸ“‚ Project Structure

FLUX-FRONTEND/
β”œβ”€β”€ public/              # Static assets
β”œβ”€β”€ src/
β”‚   β”œβ”€β”€ assets/          # Images, fonts, and icons
β”‚   β”œβ”€β”€ components/      # Reusable UI components
β”‚   β”œβ”€β”€ pages/           # Application route pages
β”‚   β”œβ”€β”€ store/           # Redux store configuration
β”‚   β”œβ”€β”€ App.jsx          # Main application component
β”‚   └── main.jsx         # Entry point
β”œβ”€β”€ index.html           # HTML template
β”œβ”€β”€ package.json         # Dependencies and scripts
β”œβ”€β”€ tailwind.config.js   # Tailwind configuration
└── vite.config.js       # Vite configuration

πŸ“œ Scripts

  • npm run dev: Starts the development server.
  • npm run build: Builds the app for production.
  • npm run lint: Runs ESLint to check for code quality issues.
  • npm run preview: Locally previews the production build.

Made with ❀️ by the Flux Team

About

Resources

License

Contributing

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors

Languages