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.
- 📁 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 — MapLibre GL with geolocated projects on a Plan IGN basemap
- 🚀 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
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.
# Install microfolio via Homebrew
brew trust aker-dev/tap
brew install aker-dev/tap/microfolio
# Create a new portfolio
microfolio new my-portfolio
cd my-portfolio
# Start the development server
microfolio dev- Node.js 22.13 or later (required by pnpm 11; tested with 22.x and 24.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
- 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
📖 Complete deployment guide: doc/en/04-publication.md
# Build the site
microfolio build # or pnpm build
# Enable GitHub Pages in repository settings
# Push to main branch - automatic deploymentContributions are welcome! Fork the project, create a feature branch, and submit a Pull Request.
- A rebuilt lightbox: the image fills the height of the screen, with title, caption and EXIF metadata in a panel that opens on demand
- Project titles and the type and tag badges are links into the projects view, already filtered
- The list and projects views render their content on the server — visible to search engines and without JavaScript
- Usable on a phone: filters collapse behind a button, and list rows become cards instead of a table scrolling sideways
- Visible keyboard focus, and collapsible controls that announce their state
Node.js 22.13 or later is required (a pnpm 11 dependency).
- 🐛 Issues: GitHub Issues
- 📧 Email: hello@aker.pro
- 💬 Discussions: GitHub Discussions for questions
MIT License - See LICENSE file for details.
The lightbox shows the image full height, with its title, caption, credit and EXIF metadata in a panel you open when you want it:
Follows the system preference, with a toggle in the footer that remembers your choice.
Made with ❤️ by AKER