Skip to content
🚀 Portfolio Platform Docs

Build YourAI-Powered Portfolio

Everything you need to create, customize, and deploy a stunning AI-powered portfolio. Import from LinkedIn, GitHub, or your resume — then let visitors chat with your experience.

Production-Ready
AI-Powered
Custom Domains

What you'll learn: Data import, theme customization, AI chat setup, domain configuration, SEO optimization, and everything in between.

Getting Started: Create Your Portfolio

Getting your portfolio online takes minutes, not hours. PortfolioOS imports your existing data from LinkedIn, GitHub, or a resume PDF so you never have to manually type out your work history.

Step 1: Import from LinkedIn

Upload your LinkedIn profile export or connect via OAuth. Our parser extracts work experience, education, skills, certifications, and recommendations automatically.

Created terminal
+7
+# Export your LinkedIn data
+LinkedIn Settings → Data Privacy → Get a copy of your data
+
+# Supported export formats:
+# - LinkedIn CSV export (recommended)
+# - LinkedIn profile PDF
+# - Direct URL import (paste your public LinkedIn URL)

💡 Pro tip: You can also import directly from your public LinkedIn profile URL. PortfolioOS will scrape and structure your public profile data automatically.

Step 2: Import from GitHub

Connect your GitHub account to automatically import your repositories, contributions, and pinned projects. Your portfolio stays in sync with your GitHub activity.

Created terminal
+11
+# Connect GitHub during onboarding:
+1. Click "Import from GitHub"
+2. Authorize PortfolioOS (read-only scope)
+3. Select repositories to feature
+4. Auto-detect: Top languages, pinned repos, contributions
+
+# GitHub data imported:
+- Pinned repositories with descriptions
+- Top programming languages
+- Contribution graph summary
+- README previews

Auto Sync

New repos and contributions sync daily. Your portfolio always reflects your latest work.

Selective Display

Choose which repos to show. Hide private, archived, or old projects you no longer want featured.

Step 3: Upload a Resume PDF

Drag and drop your resume PDF and we'll parse it into structured portfolio data. Our parser handles most common resume formats including ATS-optimized layouts.

Created terminal
+12
+# Upload your resume
+1. Navigate to Dashboard → Import
+2. Select "Upload PDF Resume"
+3. Drag and drop or browse for your file
+4. Review and adjust parsed data
+
+# Supported resume sections:
+- Work experience (company, title, dates, descriptions)
+- Education (school, degree, dates, GPA)
+- Skills (categorized)
+- Certifications
+- Projects

⚠️ Important: Review parsed data carefully. Complex layouts may require manual adjustments. Use the editor to fix any misinterpreted fields.

Step 4: Manual Entry

Prefer full control? Use the portfolio editor to enter everything manually. Build your profile section by section with our intuitive form builder.

Created terminal
+7
+# Manual entry sections available:
+- Personal Info (name, bio, photo, social links)
+- Work Experience (add/remove positions, reorder)
+- Education (degrees, certifications, courses)
+- Skills (categories, proficiency levels)
+- Projects (links, descriptions, technologies)
+- Custom Sections (add anything else)

Next steps: Once your data is loaded, move on to Customization to pick a theme and adjust the look and feel of your portfolio.

Step 5: Preview and Publish

Before going live, preview your portfolio across desktop, tablet, and mobile. Make adjustments, then publish with one click.

Created terminal
+12
+# Preview workflow
+1. Click "Preview" in the editor
+2. Toggle between device sizes
+3. Test the AI chat interaction
+4. Verify all links and data
+
+# Publishing
+5. Click "Publish" to deploy
+6. Your portfolio goes live at:
+ https://portfolios.chat/your-username
+ -or-
+ https://your-custom-domain.com

💡 Pro tip: Use the draft/published workflow. Make changes in draft mode and publish when ready. Your live portfolio stays unaffected until you explicitly publish.

Customization: Themes and Layouts

Make your portfolio stand out with professional themes, custom colors, and flexible layouts. Every aspect of your portfolio is customizable without touching code.

01. Theme System

Choose from a library of professionally designed themes. Each theme provides a complete visual identity — typography, spacing, section layouts, and component styles.

Created terminal
+12
+# Built-in themes (expandable)
+- Modern: Clean, minimal, great for tech professionals
+- Creative: Bold colors, unique layouts for designers
+- Executive: Conservative, polished for leadership roles
+- Academic: Publication-focused for researchers
+- Developer: Code-themed with terminal aesthetics
+
+# Theme configuration (via dashboard)
+Theme: "Modern"
+Primary Color: "#2563eb" (adjustable)
+Font: "Inter" (pick from 20+ Google Fonts)
+Layout: "full-width" | "contained" | "sidebar"

💡 Pro tip: Each theme includes light and dark mode variants. Visitors can toggle between them, or you can lock your portfolio to a single mode.

02. Portfolio Sections

Control exactly which sections appear on your portfolio and their order. Enable, disable, and rearrange sections to tell your story the way you want.

Default Sections

Hero, About, Experience, Education, Skills, Projects, Contact, AI Chat

Optional Sections

Publications, Certifications, Testimonials, Blog, Speaking, Open Source

💡 Pro tip: Fewer sections with strong content beats many sections with thin content. Pick 5-7 sections that best represent your professional story.

03. Custom CSS and Branding

For fine-grained control, add custom CSS overrides. Set your exact brand colors, spacing, and visual preferences without limits.

Created custom.css
+13
+/* Add custom CSS in the dashboard editor */
+:root {
+ --portfolio-primary: #7c3aed;
+ --portfolio-secondary: #06b6d4;
+ --portfolio-accent: #f59e0b;
+ --portfolio-radius: 12px;
+ --portfolio-font-heading: 'Cal Sans', sans-serif;
+}
+
+/* Override any default style */
+.portfolio-hero {
+ background: linear-gradient(135deg, var(--portfolio-primary), var(--portfolio-secondary));
+}

⚠️ Important: Custom CSS is applied on top of your selected theme. Use it for tweaks, not full redesigns. For substantial changes, start from a blank-theme template.

04. Media and Assets

Upload your profile photo, cover image, resume PDF, and portfolio assets. All media is optimized and served via our CDN for fast loading.

Created terminal
+12
+# Supported assets
+- Profile photo (jpg, png, webp — max 5MB)
+- Cover image (jpg, png, webp — max 10MB)
+- Resume PDF (optional download)
+- Project screenshots
+- Logo (for branded portfolios)
+
+# Auto-optimization
+- Images resized to responsive breakpoints
+- WebP/AVIF format delivery
+- Lazy loading enabled by default
+- CDN caching with 1-year TTL

💡 Pro tip: Use a professional headshot for the profile photo and a clean, relevant cover image. First impressions matter — these are the first things visitors see.

AI Chat: Conversational Portfolio

Every portfolio comes with a built-in AI assistant that knows your experience, skills, and background. Visitors can ask questions and get answers — like having you there 24/7.

01. How It Works

When you import or enter your data, it gets indexed into a structured knowledge base. The AI assistant uses this knowledge to answer visitor questions conversationally.

Created terminal
+13
+# Data sources used by the AI:
+- Work experience (company, role, dates, achievements)
+- Education and certifications
+- Skills and proficiency levels
+- Projects and portfolio items
+- Custom sections you've added
+
+# Example visitor questions:
+"What technologies does Alex use?"
+"How many years of React experience?"
+"What was their role at Google?"
+"Do they have experience with AI/ML?"
+"When did they graduate?"

💡 Pro tip: Add a "FAQs" custom section to pre-seed answers to common questions. The AI will incorporate these into its responses.

02. Custom Personality and Tone

Configure how your AI assistant presents itself. Set the tone, communication style, and even specific instructions for how it should answer certain types of questions.

Created terminal
+10
+# AI Assistant configuration
+Tone: "professional" | "friendly" | "enthusiastic" | "technical"
+Formality: "formal" | "casual" | "balanced"
+Response Length: "concise" | "detailed"
+
+# Custom instructions (optional):
+"Always mention my AWS certifications when
+ discussing cloud experience. When asked about
+ availability, explain that I'm open to both
+ full-time and contract opportunities."

Visitor Engagement

The AI can proactively suggest questions and guide visitors through your portfolio based on their interests.

Analytics

See which questions visitors ask most. Use this insight to improve your portfolio content and FAQ section.

03. Privacy and Data Control

You have full control over what the AI can and cannot discuss. Configure data visibility at a granular level.

1

Section Visibility

Hide specific sections from the AI (e.g., salary expectations, private contact info).

2

Blocked Topics

Define topics the AI should redirect or refuse to discuss.

3

Chat History

View and manage chat history. Delete conversations at any time.

⚠️ Important: The AI only knows what you've added to your portfolio. Never include sensitive personal information (phone numbers, addresses) in portfolio data.

04. Embedding on External Sites

Want the AI chat on your personal website or landing page? Embed it as a widget with a single script tag.

Created embed.html
+15
+<!-- Add to your website -->
+<script
+ src="https://portfolios.chat/embed.js"
+ data-username="your-username"
+ data-theme="light"
+ data-position="bottom-right"
+></script>
+
+<!-- Or use the iframe embed -->
+<iframe
+ src="https://portfolios.chat/chat/your-username"
+ width="100%"
+ height="600px"
+ style="border: none; border-radius: 12px;"
+></iframe>

💡 Use case: Perfect for freelancers and agencies. Embed the AI chat on your agency site so prospects can learn about your entire team's expertise.

Domains & Deployment

Your portfolio gets a free portfolios.chat subdomain instantly. Upgrade to a custom domain for a professional presence — SSL included, no configuration headaches.

01. Automatic Subdomain

Every account gets a free subdomain at portfolios.chat/your-username. Your portfolio is live instantly after publishing — no DNS, no setup.

Created terminal
+12
+# Your free subdomain
+https://portfolios.chat/your-username
+
+# Examples
+https://portfolios.chat/janedoe
+https://portfolios.chat/alexchen
+https://portfolios.chat/sarasmith
+
+# Features
+- Instant HTTPS (auto-provisioned SSL)
+- CDN-backed global delivery
+- No setup required

💡 Pro tip: Share your portfolios.chat link on LinkedIn, in email signatures, and on business cards. It's clean and professional.

02. Custom Domains

Connect your own domain name for a branded experience. Available on Pro plans. SSL certificates are provisioned and renewed automatically.

Created terminal
+16
+# Step 1: Add your domain
+Settings → Domains → Add Domain
+Enter: janedoe.com
+
+# Step 2: Configure DNS
+Type: CNAME
+Name: @ (or www)
+Value: portfolios.chat
+
+# Step 3: Verify ownership
+Add TXT record:
+portfolios-chat-verification=your-token
+
+# Step 4: Wait (5-30 min)
+SSL auto-provisioned via Let's Encrypt
+Domain verified and active

Supported Configurations

apex domain (example.com), www subdomain (www.example.com), or custom subdomain (portfolio.example.com)

SSL Certificates

Auto-renewed via Let's Encrypt. Wildcard certs for subdomains. No manual renewal needed.

⚠️ Important: DNS changes can take up to 48 hours to propagate globally, though typically complete within 5-30 minutes. Verify propagation before marking the domain as active.

03. Deployment on Vercel

Every portfolio is deployed on Vercel's edge network. Your site gets全球 CDN distribution, automatic HTTPS, and instant cache invalidation on updates.

Created vercel.json
+17
+// Built-in deployment infrastructure
+{
+ "regions": ["iad1", "hkg1", "lhr1"],
+ "headers": [
+ {
+ "source": "/(.*)",
+ "headers": [
+ { "key": "X-Frame-Options", "value": "SAMEORIGIN" },
+ { "key": "X-Content-Type-Options", "value": "nosniff" }
+ ]
+ }
+ ],
+ "cache": {
+ "images": { "optimize": true },
+ "static": { "ttl": 31536000 }
+ }
+}

Deployment Triggers

Publishing updates triggers automatic redeployment. Zero downtime — visitors see the old version until the new one is ready.

Preview Deployments

Each draft generates a unique preview URL. Share it with colleagues for feedback before publishing.

💡 Pro tip: Use the preview URL feature to get feedback on portfolio changes before they go live. Share the link with mentors or peers for review.

SEO: Structured Data and Metadata

Your portfolio is SEO-optimized out of the box. Every page includes structured data, Open Graph tags, and auto-generated sitemaps so recruiters and search engines can find you.

01. Built-in Structured Data

Every portfolio page automatically includes Schema.org structured data (Person, Article, ItemList). This powers rich search results with profile photos, ratings, and contact info.

Created terminal
+16
+<!-- Auto-generated JSON-LD on your portfolio -->
+<script type="application/ld+json">
+{
+ "@context": "https://schema.org",
+ "@type": "Person",
+ "name": "Jane Doe",
+ "jobTitle": "Senior Software Engineer",
+ "description": "Full-stack engineer with 8 years experience...",
+ "knowsAbout": ["React", "TypeScript", "Python", "AWS"],
+ "alumniOf": "MIT",
+ "worksFor": {
+ "@type": "Organization",
+ "name": "Tech Corp"
+ }
+}
+</script>

💡 SEO benefit: Structured data helps you appear in Google's People Also Ask, knowledge panels, and rich snippet results — significantly increasing click-through rates.

02. Metadata and Social Cards

Control how your portfolio appears when shared on social media, messaging apps, and search results. Customize the title, description, and preview image for every page.

Created terminal
+13
+# Default metadata (auto-generated)
+Title: "Jane Doe — Software Engineer"
+Description: "Full-stack engineer specializing in React,
+ TypeScript, and cloud infrastructure. 8 years of
+ experience building scalable web applications."
+OG Image: "https://portfolios.chat/og/janedoe.png"
+
+# Customize in Settings → SEO
+Meta Title: "Jane Doe | Senior Full-Stack Engineer"
+Meta Description: "Building the future of fintech at Stripe.
+ Previously led engineering teams at Airbnb."
+Social Preview: [upload custom image]
+Canonical URL: "https://janedoe.com"

Open Graph

Optimized sharing on LinkedIn, Twitter, Facebook, and Slack. Custom og:image with your name, title, and photo.

Twitter Cards

Summary card with large image. Optimized for X/Twitter link previews with your profile information.

💡 Pro tip: A compelling meta description increases click-through rates. Include your unique value proposition and key skills in the first 160 characters.

03. Auto Sitemaps and Indexing

Your portfolio's sitemap is automatically generated and submitted to search engines. New pages and updates are indexed within hours.

Created terminal
+16
+# Auto-generated sitemap
+https://janedoe.com/sitemap.xml
+
+# Included pages:
+- / (home/hero)
+- /experience
+- /projects
+- /skills
+- /education
+- /blog (if enabled)
+
+# Indexing features
+- Auto-submitted to Google Search Console
+- robots.txt configured for optimal crawling
+- Last-modified dates for smart recrawling
+- Priority hints for important pages

⚠️ Important: While your portfolio is SEO-optimized, rankings depend on content quality, backlinks, and domain authority. Publish consistently and share your portfolio to build visibility.

04. Performance and Core Web Vitals

Every portfolio is built for speed. Our deployment pipeline optimizes images, minifies assets, and leverages edge caching — contributing to better search rankings.

Image Optimization

Automatic WebP/AVIF conversion, responsive srcset, lazy loading with blur placeholders.

Bundle Size

Code-split routes, tree-shaken CSS, minimal JS — typical portfolio loads under 100KB initial.

Edge Caching

Static assets cached at 100+ edge locations globally. Instant page loads for repeat visitors.

CDN Delivery

Global CDN with regional edge nodes. Visitors in Tokyo get the same speed as visitors in New York.

💡 SEO benefit: Core Web Vitals (LCP, FID, CLS) are a Google ranking signal. Our optimized pipeline helps your portfolio score well in all three metrics.

Resume Builder

Create a polished, ATS-friendly resume directly from your portfolio data. No need to maintain separate files — your resume stays in sync with your online presence.

01. Generate from Portfolio

Your resume is automatically generated from your portfolio data. Make changes once — it updates everywhere. Choose from professional templates optimized for ATS parsing.

Created terminal
+10
+# Resume templates
+- Standard: Classic single-column, ATS-optimized
+- Modern: Two-column layout with skills sidebar
+- Executive: Summary-focused for senior roles
+- Technical: Skills-first layout for engineers
+
+# Export formats
+PDF (letter/A4)
+JSON (for programmatic use)
+TXT (plain text for job applications)

💡 Pro tip: Always download your resume as PDF for job applications. The PDF preserves formatting across all operating systems and ATS platforms.

02. ATS Optimization

Our templates are designed to pass Applicant Tracking Systems. Proper heading hierarchy, semantic sections, and clean typography ensure machines can read your resume as well as humans.

1

Keyword Optimization

The AI analyzes your target roles and suggests skills and keywords to include for better ATS matching.

2

Action Bullet Generator

Transform weak descriptions into strong, quantified achievements. "Led team" → "Led a team of 12 engineers, delivering 3 major features ahead of schedule."

3

Format Validation

Built-in checks ensure your resume meets common ATS requirements: proper date formats, contact info, section ordering.

✅ Verified: All resume templates pass standard ATS tests (Jobscan, TopResume). Tested against major platforms including Workday, Greenhouse, and Lever.

03. Version History

Keep track of resume versions. Need to revert to an older layout or recover a previous draft? Version history has you covered.

Created terminal
+12
+# Resume versions
+- Auto-saved on every edit
+- Named saves for milestones
+ ("Applied to Google 2025")
+- 30-day version history (Pro)
+- Unlimited version history (Pro Max)
+
+# Restore workflow
+1. Open Resume Builder
+2. Click "Version History"
+3. Preview any past version
+4. Click "Restore" to revert

💡 Pro tip: Create named versions for specific job applications. Tailor your resume for different roles and save each version so you can reapply later.

Pricing & Limits

Choose the plan that fits your needs. Start free, upgrade when you need custom domains, more AI interactions, or advanced customization options.

Free Plan

Get started with everything you need for a basic portfolio. Perfect for students, early-career professionals, and anyone getting started.

Included

  • • One portfolio
  • • Free portfolios.chat subdomain
  • • 3 themes
  • • 100 AI chat messages/month
  • • Resume PDF export
  • • Basic analytics

Limits

  • • No custom domain
  • • PortfolioOS branding on portfolio
  • • 1 resume template
  • • Standard support (email)

💡 Tip: The Free plan is great for trying PortfolioOS. Upgrade when you're ready for a professional domain and more AI engagement.

Pro Lite — $9/mo

For professionals who want a polished online presence. Custom domain, more AI interactions, and advanced customization.

Everything in Free, plus:

  • • Custom domain support
  • • Remove PortfolioOS branding
  • • 5,000 AI chat messages/month
  • • All themes
  • • 3 resume templates
  • • Priority email support

Best for

Job seekers, freelancers, and professionals actively networking. The custom domain alone is worth the upgrade for a branded link on your resume.

⚠️ Note: Custom domain DNS configuration is your responsibility. We provide step-by-step setup guides and support if you get stuck.

Pro — $29/mo

The full experience. Unlimited everything, advanced analytics, multiple portfolios — for power users and agencies.

Everything in Pro Lite, plus:

  • • Up to 3 portfolios
  • • Unlimited AI chat messages
  • • All resume templates (including ATS-optimized)
  • • Custom CSS/JS injection
  • • Advanced analytics (traffic sources, chat logs)
  • • API access
  • • Priority support (chat + email)

Best for

Designers, developers, consultants, and agencies managing multiple client portfolios. The API access enables custom integrations.

💡 Pro tip: Use the multiple portfolio slots for different professional personas — one for engineering roles, one for consulting, one for speaking engagements.

Usage Limits and Fair Use

All plans include fair use provisions. Here's what counts against your limits and what's unlimited:

Created terminal
+14
+# What counts toward limits
+- AI chat messages (1 message = 1 question + answer)
+- AI resume generation requests
+- Custom domains (count per domain)
+- Portfolios (count per published site)
+
+# What's unlimited on all plans
+- Profile views/visitors
+- Resume downloads (PDF)
+- Portfolio edits and drafts
+- Theme changes and previews
+- Media uploads (up to 50MB total)
+- Social sharing
+- Sitemap generation

⚠️ Important: AI message limits reset monthly. Unused messages do not roll over. Upgrade or change plans at any time — changes take effect immediately.

Ready to Build Your Portfolio?

You now have everything you need to create a stunning AI-powered portfolio. Start with the Getting Started section above and customize your way to a professional online presence.

🎯 Your First Steps

  • • Import from LinkedIn or GitHub
  • • Upload your resume PDF
  • • Pick a theme and customize colors
  • • Preview your portfolio

🚀 Going Further

  • • Configure a custom domain
  • • Optimize SEO metadata
  • • Fine-tune AI chat personality
  • • Generate your ATS-ready resume

Remember: Start with good data, choose a clean theme, and let your experience speak for itself. The AI chat handles the rest — visitors get a conversational experience that sets you apart.

Built for professionals who want their experience to speak for itself.