microfolio

🇫🇷 Lire en français

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