🚀 Neo Portfolio CLI & Template

Create a modern, customizable developer portfolio in seconds - with a single command. Built with Next.js 16, React 19, TypeScript, and Tailwind CSS 4. Zero config, no API keys, no environment variables - just edit one file and deploy.

🌐 View the Landing Page  •  ✨ See a live example

⚡ Quick Start

# Interactive (prompts for a project name, default: neo-portfolio)
npx create-neo-portfolio

# Or pass the name directly
npx create-neo-portfolio my-portfolio
cd my-portfolio
npm run dev

The CLI scaffolds the project, installs dependencies, initializes a git repo, and you're ready to go. Open http://localhost:3000.

🎨 Make It Yours

Almost everything is driven from two files:

| What | Where | | --- | --- | | Name, title, bio, location, email, social usernames | src/app/constants/data.ts → ABOUT_ME, USER_NAMES, SOCIAL_LINKS | | Skills (icon grid) | src/app/constants/data.ts → SKILLS (skillicons.dev slugs) | | Experience, education, testimonials | src/app/constants/data.ts → EXPERIENCE, EDUCATION, TESTIMONIALS | | Projects (+ their detail pages) | src/app/constants/projects.ts → PROJECTS |

Then:

• Images - replace the placeholders in public/ and src/app/opengraph-image.png with your own.
• Contact form - set CONTACT_FORM_ENDPOINT in data.ts (free endpoint at Formspree).
• Meeting button - set your cal.com handle in data.ts (USER_NAMES.calUsername).
• Sections - add, remove, or reorder them in src/app/page.tsx.

Change your name in data.ts and it updates everywhere - navbar, metadata, JSON-LD, sitemap, and the GitHub contribution graph all follow automatically.

✨ Features

• Modern stack - Next.js 16 (App Router) + React 19 + Tailwind CSS 4 + TypeScript
• Zero config - no environment variables or API keys required
• Content-driven - everything lives in data.ts / projects.ts
• Dedicated project pages - each project gets its own /projects/<slug> route
• Live GitHub contribution graph as a banner
• Dark / light theme with system preference + smooth toggle
• SEO-ready - metadata, JSON-LD, OpenGraph image, sitemap.xml, robots.txt
• Polished details - animated canvas cursor, glassy buttons, smooth scrolling
• Fully responsive and fast out of the box

🚀 Deploy

Deploy to Vercel (recommended) or any platform that supports Next.js - push to GitHub and import the repo.

🙌 Credits

Built by Deepak Modi with Next.js, Tailwind CSS, and TypeScript.

If this helped you, a ⭐ on the repo means a lot!

📄 License

MIT