---

name: magic-portfolio description: Next.js 16 portfolio with MDX blog/projects, Once UI, auto SEO, and endless theming.

Magic Portfolio

A simple, clean portfolio template with MDX-based blog and projects, automatic SEO, gallery, and endless theming options.

Tech Stack

• Framework: Next.js 16
• React: React 19
• UI: Once UI
• Styling: Sass
• Content: MDX
• Package Manager: npm
• Dev Port: 3000

Setup

1. Clone the Template

Copygit clone --depth 1 https://github.com/Eng0AI/magic-portfolio-template.git .

If the directory is not empty:

Copygit clone --depth 1 https://github.com/Eng0AI/magic-portfolio-template.git _temp_template
mv _temp_template/* _temp_template/.* . 2>/dev/null || true
rm -rf _temp_template

2. Remove Git History (Optional)

Copyrm -rf .git
git init

3. Install Dependencies

Copynpm install

Build

Copynpm run build

Deploy

Vercel (Recommended)

Copyvercel pull --yes -t $VERCEL_TOKEN
vercel build --prod -t $VERCEL_TOKEN
vercel deploy --prebuilt --prod --yes -t $VERCEL_TOKEN

Netlify

Copynetlify deploy --prod --dir=.next

Customization

• src/resources/once-ui.config.js - Theme and UI settings
• src/resources/content.js - Site content
• src/app/blog/posts/ - Blog posts in MDX
• src/app/work/projects/ - Project case studies

Development

Copynpm run dev

Opens at http://localhost:3000

Requires Node.js v18.17+