Portfoliov1

Personal portfolio website built with Next.js App Router, TypeScript, Tailwind CSS, MDX, and Framer Motion.

#portfolio #nextjs #typescript #tailwindcss #mdx #framer-motion #vercel

Table of Contents

• Overview
• Features
• Tech Stack
• Project Structure
• Quick Start
• Environment Variables
• Scripts
• Deployment
• Customization
• License

Overview

This repository contains the source code for my personal developer portfolio. It includes project showcases, blog support via MDX, custom UI animations, and GitHub-related dynamic sections.

Features

• Next.js App Router architecture
• Responsive, component-driven UI
• Dark mode support
• Framer Motion animations and interactive effects
• MDX-powered content/blog flow
• GitHub graph / integration sections
• SEO + Open Graph metadata
• Vercel Analytics + Speed Insights integration

Tech Stack

• Next.js 16
• React 19
• TypeScript
• Tailwind CSS 4
• Framer Motion
• MDX (@next/mdx, next-mdx-remote)
• Vercel Analytics / Speed Insights

Project Structure

app/                 # App Router pages and layouts
components/          # Shared UI + feature components
data/                # MDX content files
lib/                 # Utilities and app config
public/              # Static assets (images, audio, gifs)

Quick Start

1. Clone the repository

git clone https://github.com/Ashutoshx7/Portfoliov1.git
cd Portfoliov1

2. Install dependencies

npm install
# or
bun install

3. Run the development server

npm run dev
# or
bun run dev

4. Open in browser

http://localhost:3000

Environment Variables

Create a .env.local file in the project root:

# Optional: used by GitHub API-backed sections
GITHUB_TOKEN=your_github_personal_access_token

Scripts

npm run dev      # Start development server
npm run build    # Create production build
npm run start    # Start production server
npm run lint     # Run ESLint

Deployment

Recommended deployment target: Vercel.

1. Import this repository into Vercel.
2. Configure environment variables (if required), especially GITHUB_TOKEN.
3. Deploy.

Customization

• Edit intro/content in app/page.tsx
• Update project/experience sections in components/
• Add or edit blog posts in data/*.mdx
• Replace media assets in public/

License

Licensed under the MIT License.