CV Manager / Resume Builder

This is a CV / Resume management system with an editable theme, persistent database storage, and Docker deployment ready for Unraid.

Try It in Your Browser (demo)

Launch a demo straight from GitHub — a Codespace installs and starts the app automatically, nothing to set up:

Give it a minute to build — the editor (port 3000) then opens automatically in a preview tab. The public read-only view is on port 3001 (see the Ports panel).

For demo purposes only. Codespaces run on your GitHub account's free monthly allowance, auto-stop when idle, and are meant to be discarded — don't build your real CV here. For real use, install locally with the Quick Start options below.

Features

• 7 Sections: About, Timeline (auto-generated), Experience, Certifications, Education, Skills, Projects
• Custom Sections: Add your own sections with different layout possibilities
• Full CRUD: Add, edit, delete any item
• Visibility Toggles: Hide items from PDF export while keeping them in database
• Print/PDF Export: Clean print styles, hidden items excluded
• Import/Export: Backup and restore your CV data as JSON - ideal to process the data via any LLM for optimization
• Persistent Storage: SQLite database survives container restarts
• Multi CV: Save different of your CV. Preview them and load them as need be
• Responsive Design: Works on desktop and mobile
• Auto-Generated Timeline: Timeline automatically builds from your experiences
• ATS Optimized: Schema.org markup, semantic HTML, hidden keywords for job site parsing
• SEO Ready: Dynamic robots.txt and sitemap.xml for the public site

Quick Start (Docker)

One-Line Install

curl -fsSL https://raw.githubusercontent.com/vincentmakes/cv-manager/main/install.sh | bash

Or download and run:

wget https://raw.githubusercontent.com/vincentmakes/cv-manager/main/install.sh
chmod +x install.sh
./install.sh

Manual Option 1: Docker Compose

# Clone or copy the files
cd cv-manager

# Create data directory
mkdir -p /mnt/user/appdata/cv-manager/data/uploads

# Start the container
docker-compose up -d --build

# Access at:
# - http://localhost:3000 (Admin - full edit access)
# - http://localhost:3001 (Public - read-only)

Manual Option 2: Docker Compose with Named Volume

Use docker-compose.volume.yml if you prefer Docker-managed volumes:

docker-compose -f docker-compose.volume.yml up -d --build

Manual Option 3: Docker Run

# Build the image
docker build -t cv-manager .

# Run with persistent data
docker run -d \
  --name cv-manager \
  -p 3000:3000 \
  -p 3001:3001 \
  -v /mnt/user/appdata/cv-manager/data:/app/data \
  --restart unless-stopped \
  cv-manager

Two Server Modes

Public Server Security Features (Port 3001)

• GET-only: All POST/PUT/DELETE requests blocked
• Rate limiting: 60 requests/minute per IP
• Security headers: X-Frame-Options, CSP, XSS protection
• No sensitive data: Email/phone not exposed in API
• Visible items only: Hidden items not returned by API
• No IDs exposed: Database IDs not included in responses
• SEO files: Dynamic robots.txt and sitemap.xml

Cloudflare Tunnel Setup

Point your CF tunnel to port 3001 for public access:

# In your cloudflared config
ingress:
  - hostname: cv.yourdomain.com
    service: http://cv-manager:3001

The sitemap.xml and robots.txt are automatically generated with the correct domain based on the incoming request headers.

Unraid Deployment

Method 1: Install from Unraid Apps

1. In the Apps tab, look for "cv manager".
2. Install cv-manager first then cv-manager-public

Method 2: Docker Compose Manager Plugin

1. Install the "Docker Compose Manager" plugin from Community Apps
2. Create a new stack with the docker-compose.yml content
3. Set the path for data persistence (e.g., /mnt/user/appdata/cv-manager/data)
4. Start the stack

Data Persistence

The SQLite database is stored in the data directory. Make sure to:

1. Mount /app/data to a persistent location on your host
2. Back up the cv.db file periodically
3. Use the Export feature for JSON backups

Profile Picture

To add your profile picture:

1. Name your picture picture.jpeg
2. Place it in the data/uploads/ folder:
   • Docker: /app/data/uploads/picture.jpeg (inside container)
   • Unraid bind mount: /mnt/user/appdata/cv-manager/data/uploads/picture.jpeg
   • Docker volume: Use docker cp picture.jpeg cv-manager:/app/data/uploads/

The picture will automatically display instead of initials. If no picture is found, initials are shown as fallback.

Supported format: JPEG (must be named picture.jpeg)

API Endpoints

Importing Your Existing Data

Create a JSON file with your CV data and use the Import button, or POST to /api/import:

{
  "profile": {
    "name": "Your Name",
    "initials": "YN",
    "title": "Your Title",
    "subtitle": "Your tagline",
    "bio": "Your bio...",
    "location": "City, Country",
    "linkedin": "https://linkedin.com/in/yourprofile",
    "languages": "English, French"
  },
  "experiences": [
    {
      "job_title": "Senior Developer",
      "company_name": "Company Inc",
      "start_date": "2020-01",
      "end_date": "",
      "location": "Remote",
      "country_code": "us",
      "highlights": ["Led team of 5", "Delivered project X"]
    }
  ],
  "certifications": [
    {
      "name": "AWS Solutions Architect",
      "provider": "Amazon",
      "issue_date": "Jan 2023"
    }
  ],
  "education": [
    {
      "degree_title": "MSc Computer Science",
      "institution_name": "University",
      "start_date": "2010",
      "end_date": "2014",
      "description": "Focus on AI"
    }
  ],
  "skills": [
    {
      "name": "Programming",
      "icon": "💻",
      "skills": ["JavaScript", "Python", "Go"]
    }
  ],
  "projects": [
    {
      "title": "Project Name",
      "description": "What it does",
      "technologies": ["React", "Node.js"]
    }
  ]
}

Environment Variables

Development

# Install dependencies
npm install

# Run in development mode (auto-reload)
npm run dev

# Run in production mode
npm start

License

MIT