A full-stack, self-hosted personal portfolio built with Next.js 16. Fully dynamic with an admin panel, markdown blog, image uploads, and Docker-based deployment.

→ View Live portfolio — deployed portfolio for public views.

→ View interactive slideshow — portfolio sections and admin panel, dark & light.

• Dynamic content — all sections (about, resume, projects, blog, contact) are managed via a built-in admin panel and stored in MongoDB
• Markdown blog — rich markdown editor with GFM support, live preview, syntax highlighting, and dedicated post pages (/blog/[id])
• Image uploads — drag-and-drop or URL paste, uploaded to any S3-compatible storage (RustFS, MinIO, AWS S3)
• Admin panel — protected by JWT session, full CRUD for all content
• Email validation — contact form only accepts verified providers (Gmail, Outlook, Yahoo, iCloud, ProtonMail, etc.)
• Sketch/dashed theme — hand-drawn aesthetic with dark/light mode toggle
• Static fallbacks — all sections fall back to static data if the API is unavailable
• Docker ready — multi-arch image (amd64 + arm64) published to GHCR on every push to main

• Node.js 20+
• MongoDB (local or Atlas)
• An S3-compatible storage bucket (optional — image uploads won't work without it)

# 1. Clone the repo
git clone https://github.com/geomachine/portfolio.git
cd portfolio

# 2. Install dependencies
npm install

# 3. Set up environment variables
cp .env.local.example .env.local
# Edit .env.local with your values

# 4. Start MongoDB (Docker)
docker run -d \
  --name mongodb \
  -p 27017:27017 \
  -e MONGO_INITDB_DATABASE=portfolio \
  -v mongodb_data:/data/db \
  mongo:7

# 5. Start the dev server
npm run dev

Open http://localhost:3000 to see the portfolio.
Admin panel is at http://localhost:3000/admin.

# MongoDB
MONGODB_URI=mongodb://localhost:27017/portfolio

# Admin credentials
ADMIN_EMAIL=[email protected]
ADMIN_PASSWORD=your-secure-password

# JWT secret — use a long random string in production
JWT_SECRET=your-super-secret-jwt-key

# S3-compatible image storage
RUSTFS_ENDPOINT=https://your-storage-endpoint
RUSTFS_REGION=us-east-1
RUSTFS_ACCESS_KEY=your-access-key
RUSTFS_SECRET_KEY=your-secret-key
RUSTFS_BUCKET=portfolio
RUSTFS_PUBLIC_URL=https://your-storage-endpoint

docker build -t portfolio .
docker run -p 3000:3000 --env-file .env.local portfolio

docker pull ghcr.io/geomachine/portfolio:latest
docker run -p 3000:3000 --env-file .env.local ghcr.io/geomachine/portfolio:latest

Every push to main triggers a GitHub Actions workflow that:

1. Builds a multi-arch Docker image (linux/amd64, linux/arm64)
2. Pushes it to GitHub Container Registry (ghcr.io)
3. Tags it as latest + branch + SHA
4. Triggers a staging deployment via repository dispatch

Versioned releases are triggered by pushing a v*.*.* tag.

git tag v1.0.0
git push origin v1.0.0

src/
├── app/
│   ├── admin/          # Admin panel pages
│   ├── api/            # REST API routes
│   ├── blog/[id]/      # Dedicated blog post pages
│   └── page.js         # Main portfolio page
├── components/
│   ├── admin/          # Admin UI components + markdown editor
│   ├── sections/       # Portfolio sections (About, Resume, Blog, etc.)
│   └── Sidebar.js      # Profile sidebar
└── lib/
    ├── db/             # Mongoose models + connection
    ├── api/            # JWT, auth middleware, response helpers
    └── storage.js      # S3 upload utility

Want to use this as your own portfolio? Click "Use this template" on the sidebar or:

1. Fork / use as template on GitHub
2. Update .env.local with your credentials
3. Edit the static fallback data in each section component
4. Deploy via Docker or Vercel

MIT — free to use, modify, and distribute.