A beautiful, open-source, self-hosted portfolio platform for creative professionals.
Features • Quick Start • Configuration • Usage • Tech Stack • License
Slatefolio is a modern, full-stack portfolio platform designed for developers, designers, and creative professionals who want complete control over their online presence. Built with Next.js 15 and Express, it provides a stunning visual experience with interactive sacred geometry backgrounds, multilingual support, and a powerful admin dashboard.
Self-host your portfolio with Docker, manage your projects through an intuitive CMS, and showcase your work with elegant animations and responsive design.
- 🎨 Interactive Visual Design — Mesmerizing sacred geometry animations with hover and click effects
- 🌍 Multilingual Support — Built-in i18n with English, Spanish, and Portuguese
- 📱 Fully Responsive — Optimized for all devices and screen sizes
- 🔐 Secure Admin Panel — Password + WebAuthn/Passkey authentication
- 📝 Rich Content Management — Markdown editor for project descriptions
- 🖼️ Media Management — Image and video uploads with automatic optimization
- 📄 Resume Builder — Upload and manage your downloadable resume
- 💬 Testimonials — Showcase client and colleague endorsements
- 📧 Contact Form — SMTP-powered contact form with email notifications
- 🐳 Docker Ready — One-command deployment with Docker Compose
- Docker and Docker Compose
- Node.js 20+ and pnpm (for local development)
- A domain (for production) or localhost (for development)
git clone https://github.com/yourusername/slatefolio.git
cd slatefolioCreate a .env file in the root directory:
cp .env.example .env # if available, or create manuallySee Configuration for all environment variables.
Development (with hot-reloading):
pnpm install
pnpm devThis starts MongoDB in Docker (the mongo service from docker-compose.yml) and runs the frontend and backend natively in watch mode, with hot-reloading.
Production:
docker compose up -d- Portfolio: http://localhost:8080
- Admin Panel: http://localhost:8080/admin
On first visit to /admin, you'll be prompted to create your admin account.
Create a .env file in the project root with the following variables:
| Variable | Description | Example |
|---|---|---|
JWT_SECRET |
Secret key for JWT token signing (use a strong random string) | your-super-secret-jwt-key-min-32-chars |
FRONTEND_PORT |
Port for the Next.js frontend | 8080 |
BACKEND_PORT |
Port for the Express backend | 5050 |
NEXT_PUBLIC_BACKEND_URL |
Public URL of the backend API | http://localhost:5050 |
| Variable | Description | Example |
|---|---|---|
WEB_NAME |
Relying Party name displayed during passkey registration | Slatefolio |
WEB_ID |
Your domain (without protocol) | localhost or yourdomain.com |
WEB_ORIGIN |
Full origin URL | http://localhost:8080 |
| Variable | Description | Example |
|---|---|---|
SMTP_HOST |
SMTP server hostname | smtp.gmail.com |
SMTP_PORT |
SMTP server port | 587 |
SMTP_SECURE |
Use TLS (true for port 465) |
false |
SMTP_USER |
SMTP username/email | your-email@gmail.com |
SMTP_PASS |
SMTP password or app password | your-app-password |
SMTP_FROM_EMAIL |
Sender email address | noreply@yourdomain.com |
CONTACT_EMAIL |
Email to receive contact submissions | you@yourdomain.com |
| Variable | Description | Default |
|---|---|---|
UPLOADS_URL |
Public URL path for uploaded files | /uploads |
NEXT_PUBLIC_SOURCE |
Source identifier for analytics | — |
# Application
FRONTEND_PORT=8080
BACKEND_PORT=5050
NEXT_PUBLIC_BACKEND_URL=http://localhost:5050
# Security
JWT_SECRET=change-this-to-a-very-long-random-string-at-least-32-characters
# WebAuthn (Passkeys)
WEB_NAME=Slatefolio
WEB_ID=localhost
WEB_ORIGIN=http://localhost:8080
# Email (optional - for contact form)
SMTP_HOST=smtp.gmail.com
SMTP_PORT=587
SMTP_SECURE=false
SMTP_USER=your-email@gmail.com
SMTP_PASS=your-app-password
SMTP_FROM_EMAIL=noreply@yourdomain.com
CONTACT_EMAIL=you@yourdomain.comAccess the admin panel at /admin to manage your portfolio:
- First-Time Setup: Create your admin account with username, email, and password
- Profile: Edit your bio, title, location, social links, and skills
- Projects: Add, edit, and reorder your portfolio projects
- Testimonials: Manage client and colleague testimonials
- Resume: Upload your downloadable resume/CV
- Settings: Register passkeys for passwordless authentication
Slatefolio supports two authentication methods:
- Password: Traditional username/password login
- Passkeys (WebAuthn): Passwordless authentication using biometrics, security keys, or device PIN
After initial setup, you can register passkeys in the admin settings for enhanced security.
Each project supports:
- Localized title and description (Markdown supported)
- Multiple images and video thumbnails
- Tech stack and platform tags
- External links (demo, source code, etc.)
- Featured/hidden status
- Custom ordering
Add or modify translations in apps/frontend/messages/:
en.json— Englishes.json— Spanishpt.json— Portuguese
The locale switcher automatically appears in the UI.
- Next.js 15 — React framework with App Router
- TypeScript — Type-safe JavaScript
- SCSS Modules — Scoped component styling
- Tailwind CSS — Utility-first CSS framework
- next-intl — Internationalization
- Express.js — Node.js web framework
- MongoDB — Document database
- Mongoose — MongoDB ODM
- SimpleWebAuthn — WebAuthn/Passkey authentication
- Sharp — Image processing
- Docker — Containerization
- pnpm — Fast, disk-efficient package manager
- Monorepo architecture with pnpm workspaces
slatefolio/
├── apps/
│ ├── backend/ # Express.js API server
│ │ ├── src/
│ │ │ ├── controllers/ # Route handlers
│ │ │ ├── middleware/ # Auth middleware
│ │ │ └── models/ # Mongoose schemas
│ │ └── scripts/ # Database seed scripts
│ └── frontend/ # Next.js application
│ ├── src/
│ │ ├── app/ # App Router pages
│ │ ├── components/ # React components
│ │ ├── contexts/ # React contexts
│ │ ├── hooks/ # Custom hooks
│ │ └── types/ # TypeScript types
│ ├── messages/ # i18n translations
│ └── public/ # Static assets
├── docker-compose.yml # Production compose
├── package.json # Root workspace scripts (pnpm dev)
└── pnpm-workspace.yaml # Monorepo config
Development runs the apps natively (instant hot-reloading, local node_modules
for your editor) and only uses Docker for MongoDB:
# One-time setup
pnpm install
# Start MongoDB (Docker) + frontend and backend in watch mode
pnpm dev
# Stop the apps with Ctrl-C; Mongo keeps running in the background
pnpm mongo:stop # stop the Mongo container when you're donepnpm dev loads the root .env (via dotenv-cli) and passes it to both apps —
the same variables Docker Compose injects in production. The frontend runs
next dev --turbopack and the backend runs tsx watch, so both reload on
save. Data persists in the mongo_data Docker volume either way.
To test the production build pipeline end to end:
docker compose up -d --build
docker compose logs -f
docker compose downPopulate the database with sample data:
# Enter the backend container
docker compose exec backend sh
# Run seed scripts
npx ts-node scripts/populate-profile.ts
npx ts-node scripts/populate-projects.ts
npx ts-node scripts/populate-testimonials.ts-
Set production values in your
.env:- Use your actual domain for
WEB_IDandWEB_ORIGIN - Set a strong
JWT_SECRET - Configure SMTP for contact form
- Use your actual domain for
-
Run production compose:
docker compose -f docker-compose.yml up -d
-
Configure your reverse proxy (nginx, Caddy, Traefik) to:
- Serve the frontend on ports 80/443
- Proxy
/apirequests to the backend - Handle SSL termination
Docker Compose creates two persistent volumes:
mongo_data— MongoDB databaseuploads_data— Uploaded media files
Contributions are welcome! Please feel free to submit a Pull Request.
- Fork the repository
- Create your feature branch (
git checkout -b feature/amazing-feature) - Commit your changes (
git commit -m 'Add amazing feature') - Push to the branch (
git push origin feature/amazing-feature) - Open a Pull Request
This project is licensed under the MIT License - see the LICENSE file for details.
Built with ❤️ by Jezz Lucena