Skip to content

Repository files navigation

🚀 Nitish Vishwakarma — Portfolio Website

An interactive, animation-driven personal portfolio built with React, Three.js, and GSAP

React TypeScript Vite Three.js GSAP License

Live Demo · Report Bug · Request Feature


📖 Overview

This is the source code for my personal developer portfolio — a fully responsive, interactive site combining 3D graphics, scroll-driven animation, and clean full-stack fundamentals. It's built to showcase projects, skills, and experience through a smooth, immersive user experience rather than a static page.

Feel free to explore the code, fork it, and use it for learning and inspiration.


✨ Features

  • 🎮 Interactive 3D character model rendered in real time with Three.js / React Three Fiber
  • 🌀 Buttery-smooth scroll animations powered by GSAP, ScrollTrigger, and ScrollSmoother
  • ✂️ Animated text reveals using GSAP SplitText
  • 📱 Fully responsive across desktop, tablet, and mobile
  • Optimized performance with Vite's fast build pipeline and Draco-compressed 3D models
  • 🎨 Custom cursor interactions and micro-animations throughout
  • 🧩 Modular component architecture for easy customization and extension

⚙️ Tech Stack

Category Technologies
Core React · TypeScript · Vite
3D & Graphics Three.js · React Three Fiber · Drei · WebGL · Draco Compression
Animation GSAP · ScrollTrigger · ScrollSmoother · SplitText
Styling CSS3
Deployment Vercel / Netlify

🚀 Getting Started

Prerequisites

  • Node.js v18+
  • npm (or yarn/pnpm)

Installation

# Clone the repository
git clone https://github.com/Nitish204/portfolio.git

# Navigate into the project
cd portfolio

# Install dependencies
npm install

Development

npm run dev

The site will be available at http://localhost:5173.

Production Build

npm run build
npm run preview

📁 Project Structure

portfolio/
├── public/
│   ├── models/          # 3D model assets (.glb)
│   └── images/          # Static images
├── src/
│   ├── components/      # React components (Landing, About, Work, Career, Contact...)
│   ├── components/utils/# Animation & effect utilities
│   ├── data/             # Static data used across components
│   └── main.tsx          # App entry point
├── index.html
└── vite.config.ts

🎨 Assets Usage

Some 3D assets included in this repository are free to use for learning purposes.

However:

  • The original 3D avatar used on the live portfolio is not included in this repository.
  • That avatar is a custom asset created over roughly a month.
  • It is not open source, but reuse of the version on the live site is permitted.

For official GSAP Club plugins, refer to the GSAP installation docs.


🖼️ Preview

Portfolio Preview


📬 Contact

Nitish Vishwakarma


📄 License

This project is licensed under the MIT License — feel free to use it for learning, with credit appreciated.


If you found this project useful or inspiring, consider giving it a ⭐

About

Interactive 3D portfolio built with React, Three.js & GSAP — smooth scroll animations, real-time 3D character, and a fully responsive design.

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages