Skip to content

Latest commit

 

History

204 Commits

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

OpResume

No login, beautifully crafted online resume builder — Data stored locally only, zero leak risk, export anytime

React TypeScript Vite Tailwind CSS License: MIT

简体中文 | English

👉 Get Started

OpResume Preview

✨ Key Features

🎨 Professional Typesetting Engine

  • Multi-dimensional layout control: Freely adjust margins, section spacing, and line height with sliders — no more Word formatting nightmares.
  • Multiple classic templates: 4+ carefully curated industry-standard templates (including ATS-friendly styles, single-column corporate layouts, etc.) with seamless one-click switching.
  • Theme color customization: 8+ meticulously crafted preset color themes to match the visual tone of different industries.
  • Smart auto-pagination: Automatic visual page breaks when content exceeds A4 boundaries, with a modern floating page indicator.

🤖 AI-Powered Assistant

  • AI Resume Import: Upload a PDF resume and let AI automatically extract and populate information for quick migration.
  • AI Content Rewrite: Optimize your resume content with one click to enhance professionalism and clarity.

🚀 Ultimate User Experience

  • WYSIWYG editing: Sidebar drawer-style form editing with real-time preview on the main canvas.
  • Privacy protection mode: One-click redaction mode that automatically masks name, phone, email, and other sensitive info — perfect for sharing resumes in communities for review.
  • Smooth drag & drop sorting: Powered by @dnd-kit, entries within work experience, project descriptions, and other sections can be freely reordered via drag and drop.
  • Rich text & smart fields: Tiptap-based rich text editor supports bold, lists, and links; the system can auto-calculate age and tenure from your dates — all optional, with one-click hiding to fit regional conventions.

🔒 Data Security & Export

  • No login, zero upload: All data is stored exclusively in the browser's localStorage — no backend, no database, your privacy is fully in your hands.
  • JSON import/export: One-click export of your complete resume configuration as a JSON file for backup, migration, or cross-device use; import existing configurations to restore instantly.
  • Native PDF export: Uses the browser's native window.print() for high-fidelity export, with selectable text and ATS-friendly output.

🚀 Quick Start

Prerequisites

Installation & Running

# 1. Clone the repository
git clone https://github.com/oopooa/opresume.git
cd opresume

# 2. Install dependencies
npm install

# 3. Start the dev server
npm run dev

Open http://localhost:5173 in your browser and start crafting your perfect resume.

Build & Deploy

# Build for production
npm run build

# Preview the build
npm run preview

🏗️ Tech Stack

Category Choice
Core Framework React 18 + Vite 5 + TS 5
UI & Styling Tailwind CSS 3 + shadcn/ui
State Management Zustand 5
Rich Text Editing Tiptap 3
Drag & Drop @dnd-kit
Animation Framer Motion 11
Internationalization react-i18next

🗺️ Roadmap

  • Resume JSON import/export
  • Rich text editor
  • Drag & drop module sorting
  • Two-column layout with section drag & drop
  • Template switching
  • Custom typography settings
  • Smart pagination (single-column templates)
  • Privacy redaction mode
  • Internationalization (i18n) support
  • AI-powered resume import
  • AI rewrite
  • Multiple AI provider support
  • AI resume scoring & analysis
  • Multiple resume management
  • Smart fit-to-page
  • More templates

📁 Project Structure

src/
├── components/
│   ├── Resume/            # Core resume rendering engine
│   │   ├── templates/     # 🌟 Multiple templates (auto-registered)
│   │   └── modules/       # Base module renderers (experience, education, skills, etc.)
│   ├── Editor/            # Sidebar drawer & dynamic forms
│   ├── Toolbar/           # Top toolbar (appearance controls / export)
│   ├── Settings/          # Settings panel (AI provider configuration, etc.)
│   └── ui/                # shadcn/ui base component library
├── config/                # Configuration files
│   └── ai-providers/      # AI provider configurations
├── store/                 # Zustand state slices
├── services/              # Business logic (AI generation/polish, PDF parsing, data storage, etc.)
├── hooks/                 # Custom hooks (pagination, redaction logic, etc.)
└── types/                 # Global TypeScript type definitions

⭐ Star History

If you find this project helpful, please give it a star ⭐! Your support motivates us to keep improving.


📄 License

This project is open-sourced under the MIT License. Feel free to fork, submit PRs, or open issues!

About

优派简历 OpResume - A free, open-source, local-first, privacy-focused resume builder. 免费开源简历制作工具,纯本地运行,保护隐私

Topics

Resources

Stars

265 stars

Watchers

2 watching

Forks

Releases

Packages

Contributors

Languages