Skip to content

debgotwired/clean-and-personal

Repository files navigation

Clean and Personal

Open source personal website builder with 62 beautiful production-ready templates.

Build your personal website in minutes with Claude's help. No coding required (but you can customize everything if you want).

Deploy with Vercel

GitHub stars License Templates QA

πŸŽ‰ What's New

Latest Update (March 2026):

  • βœ… 60+ TEMPLATES! - 10 new premium templates (51-60) inspired by real-world sites
  • βœ… Comprehensive QA Suite - Automated testing for HTML, CSS, JS, accessibility, responsive
  • βœ… New designs include: Signature animation, brutalist /now pages, scrollytelling, Notion-style knowledge bases
  • βœ… All templates pass QA - 0 errors, 89%+ pass rate across all test categories

Previous Update (Feb 2026):

  • βœ… 50 TEMPLATES COMPLETE! - All 50 production-ready templates shipped
  • βœ… 25 new templates added (Templates 26-50) - Specialized layouts & purpose-driven designs
  • βœ… Layout innovations - One-page scroll, split screen, horizontal scroll, masonry grids
  • βœ… Purpose-driven - Job seekers, course creators, podcasters, newsletter writers, and more

✨ Features

  • 🎨 63 Beautiful Templates - Complete collection covering every style, layout, and use case
  • πŸ§ͺ QA Suite - Automated testing for structure, HTML, CSS, JS, accessibility, responsive
  • πŸ€– Claude-Powered - Customize conversationally: "make it blue", "add a contact form"
  • πŸ“„ PDF Import - Extract info from LinkedIn, resumes, Twitter automatically
  • πŸš€ One-Click Deploy - Free hosting on Vercel
  • πŸ’― No Build Tools - Pure HTML/CSS/JS, works everywhere
  • πŸ“± Fully Responsive - Mobile-first design, looks great on all devices
  • ⚑ Fast & Clean - Minimal, optimized, production-ready
  • β™Ώ Accessible - WCAG 2.1 AA compliant, keyboard navigation
  • 🎯 2026 Trends - Bento grids, glassmorphism, Y2K retro, and more

🎯 Perfect For

  • Founders & Entrepreneurs
  • Software Engineers & Developers
  • Designers & Creatives
  • Product Managers
  • Researchers & Writers
  • Anyone who needs a clean personal site

πŸš€ Quick Start

1. Clone the Repository

git clone https://github.com/debgotwired/clean-and-personal.git
cd clean-and-personal

2. Choose Your Approach

Option A: Use Claude (Easiest)

  1. Start Claude Code

    claude
  2. Use the skill

    /website-builder
    
  3. Tell Claude what you want

    I'm a software engineer, want a dark mode portfolio
    
  4. Upload your data (optional)

    • Drag and drop your LinkedIn PDF
    • Or resume
    • Or just type your info
  5. Claude builds it for you!

    • Picks the right template
    • Customizes with your info
    • Helps you deploy

Option B: Manual Setup

  1. Browse templates

    • Open index.html in your browser to see all 62 templates
    • Or explore the templates/ directory
  2. Choose a template

    cd templates/01-founder  # or whichever you like
  3. Edit index.html

    • Update your name, bio, links
    • Add your work experience
    • Customize sections
  4. Customize styles.css (optional)

    • Change colors in CSS variables
    • Modify fonts
    • Adjust layout
  5. Deploy

3. Deploy to Vercel (Optional)

Click the button below for one-click deployment:

Deploy with Vercel

Or follow the Deployment Guide for other hosting options.

πŸ“š All 62 Templates

Core Templates (1-10) - Versatile & Popular

# Name Style Best For Preview
01 Founder Professional, light green gradient Founders, entrepreneurs View
02 Developer Dark Terminal aesthetic, neon green Engineers, technical founders View
03 Text Scholar Ultra-minimalist, long-form reading Researchers, writers, academics View
04 Minimal Clean Markdown-style, ultra-simple Designers, minimalists View
05 Playful Developer Colorful accents, fun Developer advocates, educators View
06 Blog-First Content-focused essays Technical writers, thought leaders View
07 Resume/CV Traditional one-page Job seekers, freelancers View
08 Startup Business-focused, metrics Startup founders, entrepreneurs View
09 Creative Portfolio Artistic, visual-first Designers, photographers, artists View
10 Project Showcase Card layout for projects Product managers, builders View

2026 Design Trends (11-21) - Modern & Trendy

# Name Style Best For Preview
11 Bento Grid Modular card layout (2026 trend) Modern portfolios View
12 Glassmorphism Frosted glass effects Creative professionals View
13 Y2K Retro Nostalgic 90s/2000s aesthetic Retro enthusiasts View
14 Organic Shapes Flowing natural forms Nature-inspired brands View
15 Hand-Drawn Sketchy, anti-AI aesthetic Human-touch focused View
16 Bold Typography Type-first design Type enthusiasts View
17 3D Elements Subtle depth effects Modern tech portfolios View
18 Brutalist Raw, experimental Bold creative work View
19 Swiss Style Grid-based, systematic Professional portfolios View
20 Memphis Design 80s geometric, colorful Playful brands View
21 Neumorphism Soft UI, embossed Subtle elegant design View

Professional Portfolios (22-30) - Career-Focused

# Name Style Best For Preview
22 Software Engineer Code-focused, technical Software engineers, developers View
23 UI/UX Designer Case study driven UI/UX designers View
24 Product Designer Product-focused, metrics Product designers View
25 Graphic Designer Visual-first, image gallery Graphic designers, artists View
26 Marketing Pro Campaign showcase, metrics Marketing professionals, growth marketers View
27 Consultant Services-focused, professional Business consultants, advisors View
28 Freelancer Versatile, availability status Freelancers across disciplines View
29 Illustrator Artwork gallery, masonry grid Digital illustrators, artists View
30 Animator Motion-focused, video showcase Animators, motion designers View

Layout Innovations (31-40) - Unique Structures

# Name Style Best For Preview
31 One Page Scroll Full-screen scrolling sections Product launches, presentations View
32 Multi Page Classic Traditional multi-page site Corporate websites, professional services View
33 Side Navigation Fixed sidebar, doc-style Documentation, developer portfolios View
34 Full Screen Slides Presentation-style slides Conference speakers, storytellers View
35 Magazine Layout Editorial-style magazine Writers, journalists, publishers View
36 Card Grid Pinterest-style cards Photographers, visual portfolios View
37 Timeline Chronological timeline Career journeys, project histories View
38 Split Screen Dual-pane design Personal brands, minimal portfolios View
39 Horizontal Scroll Left-to-right scrolling Creative agencies, experimental designs View
40 Masonry Grid Variable-height masonry Photography, art galleries View

Purpose-Driven (41-50) - Goal-Oriented

# Name Style Best For Preview
41 Job Seeker Resume ATS-friendly, hire-me focused Job seekers, career changers View
42 Startup Founder Pitch-focused with traction Startup founders, fundraisers View
43 Blog First Writer Content-primary portfolio Writers, bloggers, journalists View
44 Link In Bio Social hub landing page Influencers, content creators View
45 Course Creator Teaching portfolio, catalog Educators, coaches, trainers View
46 Speaker Conference speaker showcase Public speakers, thought leaders View
47 Podcast Host Episode showcase with player Podcast hosts, audio creators View
48 Newsletter Writer Substack-style newsletter Newsletter writers, essayists View
49 Community Builder Network-focused community Community managers, organizers View
50 Open Source Maintainer GitHub-focused developer OSS maintainers, library authors View

Premium Designs (51-62) - Real-World Inspired

# Name Style Best For Preview
51 Signature Minimal Dark mode, signature animation Personal brands, designers View
52 Now Page Focus Brutalist, Derek Sivers style Writers, thinkers, /now enthusiasts View
53 Warm Essayist Magazine-style, warm earth tones Newsletter writers, essayists View
54 Craft Developer Ultra-minimal, philosophy section Thoughtful developers View
55 Academic Researcher Papers, lectures, codes sections Professors, researchers View
56 Angel Investor Portfolio with antiportfolio Angel investors, VCs View
57 Knowledge Base Notion-style, sidebar navigation Digital gardeners, note-takers View
58 Scrollytelling Immersive parallax storytelling Storytellers, creatives View
59 AI Founder Dark hacker, typewriter effect AI founders, tech entrepreneurs View
60 Creative Director Services grid, testimonials Creative directors, consultants View
61 Friendly Blogger Warm greetings, light/dark toggle Tech bloggers, developers View
62 Dark Engineer Dark grid, noise overlay, animated counters Software engineers, OSS creators View

See docs/50-TEMPLATES-TAXONOMY.md for the full roadmap.

πŸ€– Claude Skill

This project includes a Claude Code skill that makes customization conversational:

# Load the skill
/website-builder

# Then talk naturally:
"I want a dark mode site for developers"
"Change the green to blue"
"Add a projects section"
"Make the font bigger"
"Import my LinkedIn PDF"

The skill can:

  • βœ… Help you choose templates
  • βœ… Parse PDFs and extract information
  • βœ… Make design changes conversationally
  • βœ… Add/remove/modify sections
  • βœ… Help with deployment
  • βœ… Answer questions about customization

See skills/website-builder.md for details.

πŸ“„ Import Your Data

Claude can automatically import from:

  • LinkedIn PDFs - Work history, education, skills
  • Resume/CV - All professional information
  • Twitter/X - Bio, links, recent posts
  • Substack - Writing samples, articles
  • GitHub - Projects, bio, activity
  • Any PDF - Just upload and Claude extracts what it can

See docs/DATA-IMPORT.md for guide.

🎨 Customization

Colors

Each template uses CSS variables for easy customization:

:root {
    --primary: #22c55e;
    --background: #fafafa;
    --text: #2d3d2d;
}

Or ask Claude: "Make the primary color blue"

Fonts

All templates use Google Fonts. Change in <head>:

<link href="https://fonts.googleapis.com/css2?family=Inter:wght@300;400;500&display=swap" rel="stylesheet">

Layout

Each template is fully customizable:

  • Add/remove sections
  • Change order
  • Modify spacing
  • Adjust responsive breakpoints

Claude can help with all of this conversationally!

🚒 Deployment

Deploy for FREE to Vercel:

  1. Push to GitHub
  2. Import to Vercel
  3. Deploy (automatic)

See docs/DEPLOYMENT.md for full guide including:

  • Custom domains
  • HTTPS setup
  • Performance optimization
  • Analytics

πŸ§ͺ QA Suite

Run automated tests on all templates:

# Install dependencies
npm install

# Run full QA suite
npm run qa

# Run with verbose output
npm run qa:verbose

# Test specific template
node qa/runner.js --template 51

# Generate screenshots + run QA
npm run qa:full

Test Categories:

  • Structure (files, sizes, config)
  • HTML (semantics, accessibility, SEO)
  • CSS (variables, responsive, focus states)
  • JavaScript (syntax, patterns, error handling)
  • Accessibility (ARIA, focus, motion)
  • Responsive (viewports, touch targets)

See qa/README.md for full documentation.

πŸ“– Documentation

🀝 Contributing

This is an open source project! Contributions welcome:

  • New templates - Add more designs
  • Features - Improve existing templates
  • Documentation - Help others get started
  • Bug fixes - Report and fix issues

See CONTRIBUTING.md for guidelines.

πŸ’‘ Examples

Sites built with Clean and Personal:

πŸ›  Tech Stack

  • Pure HTML5, CSS3, JavaScript
  • No framework required
  • No build tools needed
  • Works anywhere (Vercel, Netlify, GitHub Pages)
  • Mobile-first responsive design

πŸ“œ License

MIT License - use for personal or commercial projects, totally free.

See LICENSE for details.

⭐ Star & Fork

If you find this useful, please star the repo and share with friends!

Fork it to make it your own.

πŸ™ Credits

Created by Deb Mukherjee

Inspired by the best personal websites on the internet:

And many more listed in docs/TEMPLATES.md

πŸ“§ Contact

Questions? Found a bug? Want to contribute?


πŸ“Š Project Stats

  • Templates Completed: 62 βœ…
  • Total Files: 300+ production-ready files
  • Lines of Code: 35,000+ lines of HTML/CSS/JS
  • QA Status: βœ… Automated test suite with 70+ tests per template
  • Preview Screenshots: 186 screenshots (desktop, mobile, full-page)
  • License: MIT (free for personal and commercial use)

Built with β™₯ using Claude Opus 4.5

Deploy with Vercel

About

Open source personal website builder with 50+ templates, Claude AI customization, and one-click Vercel deployment

Resources

License

Contributing

Stars

Watchers

Forks

Packages

 
 
 

Contributors