Monopolizing Human Attention. Precision engineered telemetry, striking visuals, and mathematically formulated retention systems for creators and brands.
Welcome to the Darpan frontend codebase. This repository powers a highly-optimized, premium agency portfolio experience designed with state-of-the-art web technologies. Built to convert, the site features fluid 60fps animations, WebGL fluid simulations, and zero-layout-shift routing.
The application utilizes Next.js App Router (v15) paired with React 19 and Tailwind CSS v4 to deliver incredibly fast static pages while allowing for immersive runtime interactivity via GSAP and Three.js.
- Desktop-Exclusive Experience: In order to run pure WebGL physics and complex animations without performance constraints, the application is strictly enforced as a desktop-only experience via a sleek mobile blockade overlay.
- WebGL Interactive Background: A custom Three.js fluid simulation reacts to user cursor movements, creating continuous engaging visual feedback.
- Magnetic UI Elements: Buttons and layout components feature physical magnetism and spring physics powered by QuickTo (
GSAP). - Smooth Scrolling: Implemented globally via
Lenisfor premium scroll elasticity perfectly synced with ScrollTrigger. - Cinematic Route Transitions: Uses Custom Next.js Router transitions with preloading to completely eliminate white flashes between pages.
- Turbopack Build: Extremely fast dev server startup and hot-reloads via Next.js Turbopack.
- Zero-Dependency Junk: Audited and strictly configured to ensure minimum bundle-size overhead.
- Optimized Fonts & Media: Utilizing
next/fontfor Layout Shift prevention, and optimized image loading. - Statically Pre-rendered: Fully statically generated (SSG) deployment meaning maximum edge caching on Vercel.
| Domain | Technology | Description |
|---|---|---|
| Framework | Next.js 15 | React framework using the App Router and Turbopack. |
| Language | TypeScript | Strictly typed codebase with zero any exceptions for enterprise-grade integrity. |
| Styling | Tailwind CSS v4 | Utility-first styling wrapped with custom design system variables. |
| Animation | GSAP 3 | Deeply integrated green-sock timelines (useGSAP(), ScrollTrigger) for UI motion. |
| WebGL | Three.js | Used for custom shaders and the interactive background. |
| Scrolling | Lenis | Best-in-class smooth scroll hijacking synchronized to RequestAnimationFrame. |
| Package Manager | pnpm | Fast, disk-space efficient package management. |
Ensure you have the following installed on your machine:
- Node.js
v20.xor higher - pnpm
v9.xor higher
-
Clone the repository:
git clone <your-repository-url> cd darpan
-
Install dependencies: Using
pnpmis strictly enforced to ensure deterministic resolving and fast installation.pnpm install
-
Start the development server:
pnpm run dev
The server will launch at
http://localhost:3000with Turbopack enabled.
-
Test Type Checking & Linting:
pnpm tsc --noEmit pnpm lint
-
Create the optimized build:
pnpm run build
-
Preview the production build locally:
pnpm start
This project is perfectly optimized and completely ready to be deployed on Vercel.
- Push your code to your Git provider.
- Import the project in Vercel.
- The build settings should automatically be configured to:
- Framework: Next.js
- Build Command:
next build(Vercel automatically detectspnpm run build) - Install Command:
pnpm install
- Click Deploy.
Engineered with pixel-perfect precision.