Built-in admin for managing blogs, projects, categories, tags, testimonials, and site settings
Next.jsReactPortfolioBlog
nextjs-portfolio-website — Next.js Portfolio Template
By fabwaseem
A Next.js-based portfolio and blog platform with built-in admin, Prisma database, and many switchable themes, under the MIT license.
Explore the design
Compare the page layouts and mobile experience. Open any screenshot for a closer look.
Desktop homepage1 / 2
Desktop captureTop of page
Actual screenshot captured by the server browser.
All pages & views 2
Screenshots show visual appearance; interactive behavior may differ.
Recorded 2026-10-13View source
What stands out
A quick read of the recorded project description.
Many preset themes with one-click switching of the entire site's color scheme, including dark and light variants
Blog supports categories, tags, search, reading time, view counts, and draft/published/archived statuses
Project showcases support tech stack icons, demo links, GitHub links, and YouTube video embeds
Integrates Better Auth authentication, AWS S3 image uploads, SMTP email notifications, and optional OpenAI content generation
Uses Prisma to connect to PostgreSQL and provides an admin creation script
Template Details
This is a Next.js project for personal portfolios and blogs. The frontend uses the App Router and TypeScript, the data layer connects to PostgreSQL via Prisma, and it includes a separate admin interface. Public pages include project showcases, blog posts, categories and tags, search, a contact form, and testimonials; the admin provides CRUD for blogs, projects, categories, tags, testimonials, and site settings, plus visit statistics. Authentication uses Better Auth, image uploads rely on AWS S3 presigned URLs, email notifications use SMTP, and AI content generation is an optional OpenAI integration. The project emphasizes theme switching, with many preset color schemes included in the repository, and includes GSAP and Framer Motion animations, a custom cursor, and other interactive effects.
Before use, you need to prepare external services such as a PostgreSQL database, an S3 bucket, and an SMTP account; AI features also require an additional OpenAI API key. The repository is released under the MIT license, allowing free use, modification, commercial use, and distribution of the code, but third-party assets such as demo images, fonts, and icons require separate license checks, and external services such as domains, hosting, databases, payments, or AI may incur costs.
Next.jsPortfolioBlog
Is it right for your project?
Use Cases
- Build a personal portfolio site to showcase projects, tech stacks, and a timeline of experience
- Run a personal blog with an admin to publish articles and manage categories and tags
- Need to frequently change site color schemes and want to quickly switch appearances from preset themes
- Integrate AI-assisted content generation and SEO information into projects or blogs
- Deploy the Next.js application to Vercel or another platform that supports Next.js
Suitable For
- Developers familiar with Next.js, TypeScript, and Prisma
- Individuals or teams who can prepare external services such as PostgreSQL, S3, and SMTP themselves
- Users who need a combined portfolio and blog with a content management admin
- Users who accept the MIT license terms and will independently verify third-party asset licenses
Getting started & customization
Use these recorded setup notes alongside the repository instructions for your chosen version.
- 1
Requires Node.js 18+ and a PostgreSQL database, and a .env file with variables for database, authentication, S3, SMTP, etc.
- 2
After installing dependencies, run Prisma migration and generation commands, then create an admin account via npm run create-admin
- 3
Image uploads rely on an AWS S3 bucket, email notifications rely on an SMTP account, and AI features require an optional OpenAI API key
- 4
The admin entry is /admin/login; theme switching and site configuration are done in the admin settings panel
- 5
When deploying to Vercel or another platform, set all environment variables and run database migrations
License & source material
Usage conditions & limitations
Free to use · keep license noticeThis entry covers the free version in the public repository under the MIT license; the free scope is the code of this version and does not mean external services or third-party assets are free.
Must comply with when using
- Free use, modification, commercial use, and distribution of this version's code are permitted.
- When distributing copies or substantial portions of the code, retain the original author's copyright notice and the full MIT license notice.
- The code is provided as is; warranties and limitations of liability are governed by the original license and applicable law.
Additional costs & items to verify
- Demo images, fonts, icons, and other third-party assets must be checked against their respective licenses; the code's MIT license alone is not sufficient.
- External services such as domains, hosting, databases, payments, or AI may incur additional charges.
- Image upload functionality relies on an AWS S3 bucket; you must set up and configure an AWS account and access keys, which may incur storage and traffic fees.
- The project requires you to prepare a PostgreSQL database; database hosting or cloud services may incur additional costs.
- AI blog generation and SEO optimization features require an additional OpenAI API key and are optional external paid services.
- Email notifications rely on an SMTP account (the example uses Gmail); you must provide your own email service credentials, which may involve terms of service or fees.
- Admin authentication uses Better Auth; you must configure authentication keys and callback URLs yourself, which are project-specific external dependencies.
View Original Text Basis
Permission is hereby granted, free of charge
Original License Text
- AWS S3 bucket (for image uploads)
Original README
- PostgreSQL database
Original README
- OpenAI API key (optional, for AI features)
Original README
SMTP_HOST=smtp.gmail.com
Original README
https://github.com/fabwaseem/nextjs-portfolio-website/blob/main/LICENSEhttps://github.com/fabwaseem/nextjs-portfolio-website/blob/main/README.md- **Better Auth** - Authentication
Original README
Compiled by DeepSeek based on repository license and README ·2026-10-13. Results only cover the materials read; dependencies, images, fonts, and subsequent term changes are subject to their respective original texts.
Project checks & description sources
Template Information
- Source platforms
- GitHub
- Documentation and maintenance reference score
- More documented · 85 / 100
- Technologies
- Next.js · React
- Website type
- Portfolio · Blog
How this score is calculated
Our heuristic uses license records (up to 30), a demo link (12), a preview (10), stars (15), recorded maintenance (15), description completeness (8), feature records (5) and classification data (5). It is not a code, security or performance test, or a Google score. A link does not establish tested functionality.
What to verify for this project
- Repository update recorded
- 2026-03-15
- Screenshot last checked
- 2026-10-13
A demo link is listed. Check it with your own content and viewport sizes; its presence does not confirm that forms, authentication or payments work.
The catalog identifies Next.js as the primary stack. Check the actual dependency manifest and lockfile for versions and hosting requirements. These notes use recorded metadata, not a code audit or a deployment test.
Use a selection guide →How this description was prepared
AI-assisted description based on catalog records and repository material. Repository authors are not automatically the reviewers of this description.
Review declaration: [email protected] · 2026-10-13
Inspect the recorded source material
SHA-256: 6258f74e4243299c6a73d1454cda81b1fafcaf422380e90fb73e09a2736195d1
2026-10-13T06:16:50.919Z
Source file / repository# 🚀 Next.js Portfolio & Blog Platform <div align="center">      **A modern, feature-rich portfolio and blog platform with 178+ themes built with Next.js 16, TypeScript, and Prisma** [Live Demo](https://fabwaseem.vercel.app) · [Report Bug](https://github.com/fabwaseem/nextjs-portfolio-website/issues) · [Request Feature](https://github.com/fabwaseem/nextjs-portfolio-website/issues) · [View Themes](THEMES.md) · [Highlights](HIGHLIGHTS.md) </div> --- ## ✨ Features ### 🎨 Modern Design & Theming - **178+ Beautiful Themes** - Massive collection of pre-built color schemes - **One-click theme switching** - Change your entire site's look instantly - **VS Code-inspired UI** with sleek, developer-friendly interface - **Dark/Light mode** variants for each theme - **Fully responsive** design that works on all devices - **GSAP animations** for engaging user experience - **Custom cursor effects** and interactive elements - **Theme categories**: Vibrant, Pastel, Dark, Light, Nature, Neon, and more ### 📝 Content Management - **Full-featured blog** with categories, tags, and search - **Project showcase** with filtering and sorting - **Rich text editor** with markdown support - **Image upload** to AWS S3 with presigned URLs - **SEO optimization** with meta tags, Open Graph, and JSON-LD - **Reading time** and **view counter** for blog posts - **Featured content** highlighting - **Draft/Published/Archived** status management ### 🤖 AI-Powered Features - **AI blog generation** using OpenAI GPT - **Automatic SEO optimization** for projects and blogs - **Smart content suggestions** ### 👨💼 Admin Dashboard - **Secure authentication** with Better Auth - **Complete CRUD operations** for blogs, projects, testimonials - **Category and tag management** - **Settings panel** for site configuration - **Analytics dashboard** with view statistics - **Bulk operations** and content management ### 🎯 Portfolio Features - **Project showcase** with demo links and GitHub integration - **Tech stack display** with icons - **Video integration** (YouTube support) - **Testimonials section** - **Experience timeline** - **Skills showcase** - **Contact form** with email notifications ### 🔧 Developer Experience - **TypeScript** for type safety - **ESLint** and **Prettier** for code quality - **Husky** git hooks for pre-commit checks - **Conventional Commits** enforcement - **Hot reload** development - **Prisma ORM** for database management --- ## 🛠️ Tech Stack ### Frontend - **Next.js 16** - React framework with App Router - **React 19** - UI library - **TypeScript** - Type safety - **Tailwind CSS 4** - Utility-first CSS - **Framer Motion** - Animations - **GSAP** - Advanced animations - **Radix UI** - Accessible components - **React Hook Form** - Form management - **Zod** - Schema validation ### Backend - **Next.js API Routes** - Serverless functions - **Prisma** - Database ORM - **PostgreSQL** - Database - **Better Auth** - Authentication - **Nodemailer** - Email service ### Services - **AWS S3** - Image storage - **OpenAI API** - AI content generation - **YouTube API** - Video integration ### DevOps - **Vercel** - Deployment platform - **Husky** - Git hooks - **ESLint** - Code linting - **Commitlint** - Commit message linting --- ## 🚀 Quick Start ### Prerequisites - Node.js 18+ and npm/yarn/pnpm - PostgreSQL database - AWS S3 bucket (for image uploads) - OpenAI API key (optional, for AI features) ### Installation 1. **Clone the repository** ```bash git clone https://github.com/fabwaseem/nextjs-portfolio-website.git cd nextjs-portfolio-website ``` 2. **Install dependencies** ```bash npm install # or yarn install # or pnpm install ``` 3. **Set up environment variables** ```bash cp .env.example .env ``` Edit `.env` and add your configuration: ```env # Authentication BETTER_AUTH_SECRET=your-secret-key-here NEXT_PUBLIC_BETTER_AUTH_URL=http://localhost:3000 # Database DATABASE_URL=postgresql://user:password@localhost:5432/portfolio # AWS S3 AWS_ACCESS_KEY_ID=your-access-key AWS_SECRET_ACCESS_KEY=your-secret-key AWS_REGION=us-east-1 AWS_S3_BUCKET_NAME=your-bucket-name # Email (SMTP) SMTP_HOST=smtp.gmail.com SMTP_PORT=465 [email protected] SMTP_PASS=your-app-password # OpenAI (Optional) OPENAI_API_KEY=your-openai-key # Site URL NEXT_PUBLIC_BASE_URL=http://localhost:3000 ``` 4. **Set up the database** ```bash npx prisma migrate deploy npx prisma generate ``` 5. **Create an admin user** ```bash npm run create-admin ``` 6. **Run the development server** ```bash npm run dev ``` Open [http://localhost:3000](http://localhost:3000) to see your portfolio! --- ## 📖 Usage ### Admin Panel Access the admin panel at `/admin/login` and use the credentials you created. **Admin Features:** - 📝 Create and manage blog posts - 🎨 Manage projects with images and videos - 💬 Add and organize testimonials - 🏷️ Create categories and tags - ⚙️ Configure site settings - 📊 View analytics and statistics ### Content Management #### Creating a Blog Post 1. Navigate to `/admin/blog/new` 2. Fill in the title, excerpt, and content 3. Add categories and tags 4. Upload a featured image 5. Use AI to generate content (optional) 6. Publish or save as draft #### Adding a Project 1. Go to `/admin/projects/new` 2. Enter project details 3. Add tech stack, demo link, and GitHub link 4. Upload thumbnail and cover images 5. Optionally add a YouTube video 6. Publish when ready ### Customization #### Changing Themes The platform includes 178+ pre-built themes! Change your site's entire look with one click: 1. Go to `/admin/settings` 2. Navigate to "Theme Settings" 3. Browse through available themes 4. Click on any theme to preview 5. Save to apply **Popular Themes:** - Aurora Borealis - Northern lights inspired - Matrix - Classic green terminal - Sunset - Warm evening colors - Ocean Breeze - Cool blue tones - Cherry Blossom - Soft pink aesthetics - Midnight Oil - Deep dark theme - Golden Hour - Warm golden tones - And 171+ more! **Theme Categories:** - 🌈 Vibrant (Neon, Spectrum, Joker) - 🌸 Pastel (Blush, Lavender, Peach) - 🌑 Dark (Obsidian, Midnight, Abyss) - ☀️ Light (Snow, Pearl, Vanilla) - 🌿 Nature (Forest, Moss, Bamboo) - 🎨 Artistic (Chaos Theory, Witch Girl, Godspeed) #### Changing Site Information Edit `app/layout.tsx` to update: - Site name and title - Meta description - Social links - SEO keywords #### Styling - Modify `app/globals.css` for global styles - Update Tailwind config in `tailwind.config.ts` - Customize components in `components/` directory #### Theme The project uses a VS Code-inspired theme. To customize: - Edit color variables in `globals.css` - Modify theme provider in `components/providers/theme-provider.tsx` --- ## 📁 Project Structure ``` nextjs-portfolio-website/ ├── app/ # Next.js app directory │ ├── (pages)/ # Page routes │ │ ├── (web)/ # Public pages │ │ └── admin/ # Admin dashboard │ ├── api/ # API routes │ └── globals.css # Global styles ├── components/ # React components │ ├── admin/ # Admin components │ ├── layouts/ # Layout components │ ├── providers/ # Context providers │ └── ui/ # UI components (Radix) ├── lib/ # Utility functions ├── prisma/ # Database schema ├── public/ # Static assets ├── scripts/ # Utility scripts └── config/ # Configuration files ``` --- ## 🔒 Security - **Authentication** via Better Auth with secure session management - **Environment variables** for sensitive data - **Input validation** with Zod schemas - **SQL injection protection** via Prisma ORM - **XSS protection** with React's built-in sanitization - **CSRF protection** on API routes --- ## 🚢 Deployment ### Deploy to Vercel (Recommended) 1. Push your code to GitHub 2. Import your repository on [Vercel](https://vercel.com) 3. Add environment variables in Vercel dashboard 4. Deploy! [](https://vercel.com/new/clone?repository-url=https://github.com/fabwaseem/nextjs-portfolio-website) ### Other Platforms The app can be deployed to any platform that supports Next.js: - **Netlify** - **Railway** - **Render** - **AWS Amplify** - **DigitalOcean App Platform** Make sure to: 1. Set all environment variables 2. Run database migrations 3. Configure build command: `npm run build` 4. Set start command: `npm start` --- ## 🤝 Contributing Contributions are welcome! Please follow these steps: 1. Fork the repository 2. Create a feature branch (`git checkout -b feature/amazing-feature`) 3. Commit your changes (`git commit -m 'feat: add amazing feature'`) 4. Push to the branch (`git push origin feature/amazing-feature`) 5. Open a Pull Request Please ensure your commits follow [Conventional Commits](https://www.conventionalcommits.org/). --- ## 📝 License This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details. --- ## 👨💻 Author **Waseem Anjum** - Website: [waseemanjum.com](https://waseemanjum.com) - GitHub: [@fabwaseem](https://github.com/fabwaseem) - LinkedIn: [fabwaseem](https://linkedin.com/in/fabwaseem) - Twitter: [@fabwaseeem](https://twitter.com/fabwaseeem) --- ## 🙏 Acknowledgments - [Next.js](https://nextjs.org/) - The React Framework - [Vercel](https://vercel.com/) - Deployment platform - [Radix UI](https://www.radix-ui.com/) - Accessible components - [Tailwind CSS](https://tailwindcss.com/) - CSS framework - [Prisma](https://www.prisma.io/) - Database ORM - [Better Auth](https://www.better-auth.com/) - Authentication --- ## 📊 Stats     --- <div align="center"> **If you find this project helpful, please give it a ⭐️!** Made with ❤️ by [Waseem Anjum](https://github.com/fabwaseem) </div>
Explore similar templates
Compare previews and descriptions within the same stack and category.
tailwind-nextjs-starter-blog
A Next.js and Tailwind CSS blog starter template using Contentlayer for Markdown/MDX, with built-in SEO, code highlighting, and tags. It targets personal technical blogs and migration from Jekyll/Hugo to React, and supports one-click Vercel deployment.
Next.js · Blog
react-resume-template
A personal resume website template for software developers, built with Next.js, React, and TypeScript and styled with Tailwind CSS. Site content is driven by a single data file at /src/data/data.tsx, with types in dataDef.ts and images in src/images/.
Next.js · Portfolio
Nextjs-tailwindcss-blog-template
A personal blog template built with Next.js and Tailwind CSS, using Velite to process Markdown content. It includes home, about, contact and article pages, with a demo site and a companion YouTube tutorial.
Next.js · Blog
Next-js-Blog-Boilerplate
A blog starter built on Next.js 12 and Tailwind CSS 3, integrating TypeScript, ESLint, Prettier, and PostCSS.
Next.js · Blog
nextjs-blog-theme
A Next.js 15 and Tailwind CSS 4.x blog starter by Netlify, designed by Bejamas, with MDX support, dark/light theme switching, and environment-variable configuration. It includes a visual setup wizard for deploying to Netlify and manages content via local .mdx files.
Next.js · Blog
blog
A personal blog forked from Timlrx's tailwind-nextjs-starter-blog, built with Next.js, React, and Tailwind CSS. Content is stored as Markdown/MDX under data/, with site, author, navigation, and project data in separate files.
Next.js · Blog