Skip to content

README.md

Latest commit

聽

History

History
79 lines (62 loc) 路 3.33 KB

README.md

File metadata and controls

79 lines (62 loc) 路 3.33 KB
Raw

Brute Force - Web Weave '26

link -- brute-force-85r96bw7l-shashankvkaramudi51-8263s-projects.vercel.app

for admin use this email -- shravanti@gmail.com password -- 123456789

for student you can create one

Brute Force is the official digital hub for the CMR University technical club. It centralizes member management, event hosting, challenge systems, project showcases, media galleries, and performance tracking into one cohesive, high-performance platform.

This platform was built specifically for Web Weave '26.

馃帹 The Aesthetic: "Neo-Noir Tech"

The UI/UX is heavily inspired by the cinematography of Blade Runner 2049 and The Batman.

  • The Void (#0B0C10): The absolute background. A desaturated slate that provides depth.
  • The Glass (#12141A): Used for cards and surfaces with backdrop blurs.
  • The Hologram (#E63946): The primary brand color (Crimson Flare).
  • The Glitch (#00E5FF): The secondary tech color (Electric Cyan) used for hover states and UI feedback.
  • The Warning (#FFB703): Halogen amber used for secondary ambient lighting and streaks.

馃殌 Core Features

  1. Interactive 3D Hero: A Spline-powered 3D robot scene loading seamlessly on the homepage.
  2. Real-Time Global Leaderboard: Powered by Supabase WebSockets. Scores update instantly across all clients when an Admin approves a challenge submission.
  3. The Competitive Engine: Members can view active challenges, see difficulty ratings, and submit their GitHub repos and live URLs.
  4. Personal Dashboard: A GitHub-style 52-week activity heatmap, streak tracking, and achievement badges.
  5. Admin Control Center: A role-guarded mission control panel with a split-pane grading interface for submissions and a Recharts-powered analytics dashboard.
  6. Cinematic UI/UX: Aurora backgrounds, gooey text morphing, spotlight hover effects, and strict WCAG AA contrast compliance.

馃洜 Tech Stack

  • Framework: Next.js 14 (App Router)
  • Language: TypeScript (Strict Mode)
  • Styling: Tailwind CSS + Framer Motion
  • UI Components: shadcn/ui + 21st.dev + Aceternity UI
  • Database & Auth: Supabase (PostgreSQL) + @supabase/ssr
  • Charts: Recharts

馃捇 Running Locally

Prerequisites

  • Node.js 18+
  • Docker Desktop (for local Supabase)

Setup

  1. Clone the repository: 
    git clone <your-repo-url>
cd club
  2. Install dependencies: 
    npm install
  3. Start the local database (requires Docker): 
    npx supabase start
  4. Create a .env.local file at the root and add the keys generated by the start command: 
    NEXT_PUBLIC_SUPABASE_URL=your_api_url_here
NEXT_PUBLIC_SUPABASE_ANON_KEY=your_anon_key_here
  5. Run the development server: 
    npm run dev
  6. Open http://localhost:3000 in your browser.

馃敀 Security Architecture

  • Row Level Security (RLS): Every table in the Supabase database is locked down. Users can only update their own profiles and insert their own submissions.
  • Route Protection: Next.js Middleware intercepts all requests to /admin and /dashboard. If a user is not logged in, they are redirected to /login. If a logged-in user tries to access /admin without the ADMIN role, they are redirected back to the homepage.

Built with discipline for Web Weave '26.