⚡ Achyuth KP | Full Stack Developer

🚀 Overview

A high-performance, visually stunning developer portfolio built with modern web technologies. This project showcases advanced frontend engineering skills, featuring immersive 3D elements, fluid animations, and a responsive design that works seamlessly across all devices.

Designed to be more than just a resume, this portfolio is an experience—demonstrating expertise in React ecosystem, creative coding, and performance optimization.

✨ Key Features

• 🎨 Premium UI/UX: Custom design system using TailwindCSS with a dark, cyber-aesthetic.
• ⚡ High Performance: Powered by Vite for lightning-fast HMR and optimized production builds.
• 🌐 3D Integration: Interactive 3D elements using React Three Fiber.
• 🎬 Advanced Animations: Complex orchestrations with Framer Motion and GSAP.
• 💻 Interactive Easter Eggs: A fully functional retro Terminal (triggered via >_) with simulated system commands.
• 🎧 Generative Audio: Zero-copyright, procedural Web Audio API acid-house loops that react to 3D object hover states.
• 📖 3D Guestbook: A persistent, interactive 3D Rolodex-style guestbook featuring mechanical haptic audio feedback.
• ⌨️ Command Palette: Global quick-navigation system (Cmd+K) using cmdk.
• 📡 Live Activity Widget: Persistent system status indicator for immersive world-building.
• 📱 Fully Responsive: Mobile-first architecture ensuring perfect rendering on any screen size.
• ♿ Accessible: Built with accessibility best practices (ARIA, semantic HTML).
• 🔧 Type-Safe: 100% TypeScript codebase for strict type checking and maintainability.

🛠️ Tech Stack

• Framework: React 18
• Language: TypeScript
• Build Tool: Vite
• Styling: TailwindCSS
• Animations: Framer Motion
• 3D Graphics: React Three Fiber
• UI Components: Radix UI (Headless) + Shadcn/ui
• Routing: React Router
• Linting & Formatting: ESLint + Prettier

🏃‍♂️ Running Locally

1. Clone the repository

bash git clone https://github.com/achyuthkp27/Portfolio.git cd Portfolio

1. Install dependencies

bash npm install

1. Start the development server bash npm run dev The application will be available at http://localhost:8080.

🏗️ Building for Production

To create a production-ready build:

npm run build

The output will be in the dist directory, ready to be deployed.

🚀 Deployment

This project is configured for automated deployment to GitHub Pages using GitHub Actions.

• Workflow: .github/workflows/deploy.yml
• Trigger: Pushes to the main branch.
• Process: Builds the project and deploys the dist folder to the gh-pages branch.

📄 License

This project is licensed under the MIT License - see the LICENSE file for details.

Built with ❤️ by Achyuth KP