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
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
- Clone the repository
git clone https://github.com/Ashutoshx7/Portfoliov1.git
cd Portfoliov1
- Install dependencies
npm install
# or
bun install
- Run the development server
npm run dev
# or
bun run dev
- 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.
- Import this repository into Vercel.
- Configure environment variables (if required), especially
GITHUB_TOKEN.
- 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.