🔗 Live Demo: https://vercel.com/bishwas-thapa-magars-projects/minimal-grid-portfolio/8ir2qT16QiQUeUzZFgqGjdJ4aCqb
A fully customizable, community-driven portfolio starter built with Next.js, Tailwind CSS, Framer Motion, Lottie animations, and React Icons. Fork, customize your data & assets, and launch your own developer portfolio in minutes!
- Hero section with Lottie animation
- About section with avatar, bio, fun-fact, skills (linear & radial), tech-stack icons, timeline & testimonials
- Projects grid with images, descriptions & tech badges
- Contact modal powered by EmailJS + floating button
- Social page with styled embed cards for LinkedIn, Medium, Facebook
- Light / Dark mode via next-themes
- Responsive design: mobile → tablet → desktop
- Config-driven: all content lives in simple TypeScript data files
- Easy to fork & contribute: clear CI, issue & PR templates
- Next.js 14 (App Router)
- React & TypeScript
- Tailwind CSS + shadcn/ui
- Framer Motion for animations
- lottie-react for JSON animations
- EmailJS for contact form
- next-themes for light/dark mode
- React Icons for logos & UI icons
- Vercel (recommended) for deployment
# Fork this repo on GitHub, then:
git clone git@github.com:<YOUR-USERNAME>/minimal-grid-portfolio.git
cd minimal-grid-portfolionpm install
# or
yarn installCreate a .env.local in the project root:
NEXT_PUBLIC_EMAILJS_SERVICE_ID=your_service_id
NEXT_PUBLIC_EMAILJS_TEMPLATE_ID=your_template_id
NEXT_PUBLIC_EMAILJS_USER_ID=your_user_idObtain these values from your EmailJS dashboard.
- Avatar:
public/images/avatar.png - Resume PDF:
public/resume.pdf - Lottie Animations:
public/animations/*.json - Project Screenshots:
public/images/*.png
Edit the following files under src/data/:
- siteConfig.ts – name, profession, colors, about (avatar, bio, funFact, resumeUrl, location, languages, skills), projects, contact links
- social.ts – embed URLs for the Social page
- techStack.ts – tech names & icons
- timeline.ts – career milestones
- testimonials.ts – quotes & authors
npm run dev
# or
yarn devOpen http://localhost:3000 to see your personalized portfolio.
minimal-grid-portfolio/
├── public/
│ ├─ animations/ # Lottie JSON files
│ ├─ images/ # Avatar, project screenshots
│ └─ resume.pdf # Downloadable resume
├── src/
│ ├─ app/ # Next.js App Router pages & layout
│ ├─ components/ # Reusable UI components
│ ├─ data/ # siteConfig.ts, social.ts, techStack.ts, timeline.ts, testimonials.ts
│ ├─ styles/ # globals.css (Tailwind imports)
│ └─ theme/ # theme palettes (optional)
├── .env.local # EmailJS credentials
├── .gitignore
├── README.md
└── tailwind.config.js
- Push your fork to GitHub.
- Import the repo in Vercel.
- Add the same environment variables in Vercel’s dashboard.
- Deploy!
- Connect your GitHub repo in Netlify.
- Set the environment variables.
- Deploy command:
Publish directory:
npm run build
.next
- Fork the repo and clone locally.
- Create a feature branch:
git checkout -b feat/your-feature
- Make your changes, update data modules or assets.
- Commit with a clear message:
git add . git commit -m "feat: add new testimonial"
- Push and open a Pull Request against
main. - Use the issue & PR templates in
.github/to guide your contribution.
Licensed under the MIT License. See LICENSE for details.
Built by Your Name.
Questions or feedback? Open an issue or email bishwastmgr@gmail.com.