Portlio

Portlio public docs

About Portlio

The product philosophy, user experience principles, and core positioning behind the automation-first developer portfolio builder.

Product Philosophy

Zero Manual Duplication

GitHub as the Source of Truth

Developers already maintain their work on GitHub. Repositories, commits, READMEs, and metadata constitute the real record of a developer's skill. Portlio taps directly into this history, eliminating the need to copy-paste project details or manually type out descriptions.

Hands-Off Maintenance

Automation-First Workflow

Traditional portfolio sites go stale because updating them requires manual effort. Portlio solves this by listening for GitHub events. When you push new code or create a repository, webhooks trigger automatic syncs and background deployments, keeping your portfolio current without you thinking about it.

Complete Control

Review Before Publishing

While automation is powerful, developers need control over their public image. Portlio operates on a review-and-approve model. You decide which repositories are showcased, edit descriptions, toggle featured status, and control exactly when updates are deployed to production.

Built for Coders

Developer-First Experience

No complex drag-and-drop landing page interfaces or bloated templates. Portlio focuses on clean typography, clean code structures, fast load times, and developer-centric templates (Swiss-style lists, SaaS cards, interactive terminals, and bento grids) that load instantly.

UX Principles

Minimal Clicks

The 5-step onboarding wizard gets you from sign-in to a live, beautiful portfolio in under two minutes. No configuration bloat.

Fast Onboarding

Connect via GitHub OAuth, import repositories automatically, choose a starting template, and publish. No complex setup.

Opt-in Automation

Get clean email alerts when a new repository is created. Approve or reject it with a single click from your email or dashboard.

Progressive Disclosure

Start with essential templates and simple controls. Unlock custom colors, automated screenshot croppers, custom domains, and builder blocks as you need them.

Predictable Workflows

All templates consume the same underlying data structure. Switch templates instantly without losing your custom descriptions, screenshots, or featured project order.

Transparent Operations

Clear warnings regarding build times, webhook triggers, and permissions. No hidden background behaviors.

How Portlio Differs

GitHub-Native vs. Generic No-Code

Unlike generic website builders (Wix, Squarespace, Webflow) that treat a portfolio as a static design canvas, Portlio treats it as a dynamic representation of your GitHub workspace. We read live repo data, fetch README.md files for project summaries, and sync directly with webhooks.

Automation-Driven vs. Static Templates

Creating a site with a template repository is a good start, but it goes out of date the moment you start your next project. Portlio automatically updates your live site whenever you push to GitHub, saving you from repeating the cycle of manual maintenance.

Project Storytelling

Recruiters don't just want to see code; they want to know the *story* behind it. Portlio provides structured storytelling editors allowing you to define the **Problem, Solution, and Challenges** for each project, alongside automated screenshot capturing and cropping tools.