microfolio
A modern static portfolio generator built with SvelteKit 2 and Tailwind CSS 4 by AKER. Features a file-based content management system using folders and Markdown files. Perfect for designers, artists, architects, and creatives who want to showcase their projects elegantly and professionally.
Live Demo: https://aker-dev.github.io/microfolio/
We're looking for translators! Help us make microfolio accessible in more languages. Contact us at hello@aker.pro if you'd like to contribute a translation.
✅ Features
- 📁 File-based CMS — No database needed, just folders and Markdown files
- 🎨 Multiple Views — Projects grid, List, and Map modes
- 📱 Responsive Design — Mobile-first approach
- 🏷️ Smart Tagging — Filter counters and collapsible tag list
- 🗺️ Interactive Map — Leaflet integration with geolocated projects
- 🚀 Static Generation — Optimal performance with SvelteKit adapter-static
- 🖼️ Image Lightbox — Enhanced gallery with navigation arrows and metadata display
- 📊 EXIF/IPTC Metadata — Automatic extraction and display of image technical information
- 🌙 Dark Mode — Toggle in footer with persistent preference (system / manual / localStorage)
- ⚡ Image Optimization — WebP thumbnail generation with
pnpm optimize-images - 🔗 Shareable URLs — Filter, search, sort, and pagination state synced to URL query params
- 🌐 Internationalization — English/French via svelte-i18n, RTL-ready
- 🏷️ OG Metadata — Social sharing previews for projects and pages
- 📄 Pagination & Sorting — Customizable rows-per-page, sort by date, title, type, or location
🧪 Beta Testing Program
We're looking for beta testers! Are you a creative and want to test microfolio?
👉 Beta Tester Guide - Complete guide to get started
📧 Contact hello@aker.pro to join the testing program.
🚀 Quick Start
Option 1: Homebrew Installation (macOS - Recommended)
# Install microfolio via Homebrew
brew install aker-dev/tap/microfolio
# Create a new portfolio
microfolio new my-portfolio
cd my-portfolio
# Start the development server
microfolio dev
Option 2: Manual Installation
Prerequisites
- Node.js LTS 20+ (tested with 20.x)
- pnpm package manager
- Git for version control
# Clone the template
git clone https://github.com/aker-dev/microfolio.git my-portfolio
cd my-portfolio
# Install dependencies
pnpm install
# Start development server
pnpm dev
📖 Detailed installation guide: doc/en/01-installation.md
🖥️ Screenshots
Homepage Views
Project Views
List View
Map View
📚 Documentation
- Installation Guide - Installation and prerequisites
- Configuration - Site customization
- Adding Projects - Create and organize projects
- Publishing - Deploy your portfolio
- Beta Tester Guide - Guide for beta testers
🚀 Deployment
📖 Complete deployment guide: doc/en/04-publication.md
Quick Deploy to GitHub Pages
# Build the site
microfolio build # or pnpm build
# Enable GitHub Pages in repository settings
# Push to main branch - automatic deployment
🤝 Contributing
Contributions are welcome! Fork the project, create a feature branch, and submit a Pull Request.
Recent Features (v0.7.0)
- Dark mode toggle in footer with persistent preference
- Filter counters and collapsible tag list
- Shareable URLs with synced filter, search, sort, and pagination state
- Search input with clear button and filled background
- Rows-per-page setting synced with URL query params
- Internationalization (English/French) with RTL support
📞 Support
- 🐛 Issues: GitHub Issues
- 📧 Email: hello@aker.pro
- 💬 Discussions: GitHub Discussions for questions
📄 License
MIT License - See LICENSE file for details.
Made with ❤️ by AKER