manpage.dev

Turn your GitHub profile README into a Unix man page.

Live Demo →

What is this?

If you have a GitHub profile README (the special username/username repo), manpage.dev transforms it into a retro Unix manual page — complete with proper sections, monospace formatting, and that classic terminal aesthetic.

Usage

# Visit the site and type:
man <your-github-username>

# Or go directly to:
https://manpage.dev/<username>

# View in your actual terminal:
curl -s https://manpage.dev/<username>.1 | man /dev/stdin

Example

See it in action: manpage.dev/bryanmikaelian — a full resume with experience, skills, and education sections.

README Format

For best results, structure your profile README with man page conventions. See bryanmikaelian's README for a real example.

# Your Name — Short tagline

## SYNOPSIS
Contact info, links, location

## DESCRIPTION
A brief summary of who you are.

## EXPERIENCE
Your work history.

## SKILLS
Languages, tools, frameworks.

## EDUCATION
Degrees, certifications.

How It Works

1. Fetches your profile README from github.com/<username>/<username>
2. Parses the markdown
3. Renders it as a styled man page at manpage.dev/<username>
4. Also serves a .1 groff file for viewing in a real terminal

Tech Stack

• Static landing page with CRT terminal aesthetics
• Netlify Edge Functions for dynamic man page generation
• GitHub raw content API for README fetching

Local Development

netlify dev

License

MIT