# Magic Portfolio

> Next.js 16 portfolio with MDX blog/projects, Once UI, auto SEO, and endless theming.

- Skill: `majiayu000/magic-portfolio` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds add majiayu000/magic-portfolio`
- Raw SKILL.md: https://api.skillmd.com/api/skills/majiayu000/magic-portfolio/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Marketing & Growth
- Author: majiayu000 (https://skillmd.com/u/majiayu000)
- Updated: 2026-09-09
- Page: https://skillmd.com/skills/majiayu000/magic-portfolio

---


# 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

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

If the directory is not empty:

```bash
git 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)

```bash
rm -rf .git
git init
```

### 3. Install Dependencies

```bash
npm install
```

## Build

```bash
npm run build
```

## Deploy

### Vercel (Recommended)

```bash
vercel pull --yes -t $VERCEL_TOKEN
vercel build --prod -t $VERCEL_TOKEN
vercel deploy --prebuilt --prod --yes -t $VERCEL_TOKEN
```

### Netlify

```bash
netlify 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

```bash
npm run dev
```

Opens at http://localhost:3000

Requires Node.js v18.17+