Template Gallery	Resume Editor

AI Resume Generation	AI Resume Parsing (Image)

AI Optimization	Grammar Check

Grammar Auto-Fix	JD Match Analysis

Multi-Format Export	Share Link

Shared Resume Page

• Drag & Drop Editor — Visually arrange and reorder resume sections and items
• Inline Editing — Click any field to edit directly on the canvas
• 50 Professional Templates — Classic, Modern, Minimal, Creative, ATS-Friendly, Timeline, Nordic, Swiss, and more
• Theme Customization — Colors, fonts, spacing, and margins with live preview
• Undo / Redo — Full edit history (up to 50 steps)
• Auto Save — Configurable interval (0.3s–5s), with manual save option

• AI Chat Assistant — Conversational AI integrated in the editor, with multi-session support and persistent history
• AI Resume Generation — Generate a complete resume from job title, experience, and skills
• Resume Parsing — Upload an existing PDF or image, AI extracts all content automatically
• JD Match Analysis — Compare resume against a job description: keyword matching, ATS score, and improvement suggestions
• Cover Letter Generation — AI-tailored cover letter based on resume and JD, with tone selection (formal / friendly / confident)
• Grammar & Writing Check — Detect weak verbs, vague descriptions, and grammar issues; returns a quality score
• Translation — Translate resume content across 10 languages while preserving technical terms
• Flexible AI Provider — Supports OpenAI, Anthropic, and custom API endpoints; each user configures their own key in-app

• Multi-Format Export — PDF (Puppeteer + Chromium), Smart One-Page PDF (auto-fit to single page), DOCX, HTML, TXT, JSON
• JSON Import — Import a previously exported JSON file to restore or create a resume; supported both in the editor (overwrite current) and on the dashboard (create new)
• Link Sharing — Token-based shareable links with optional password protection
• View Counter — Track how many times a shared resume has been viewed

• Multi-Resume Dashboard — Grid and list views, search, sort (by date, name)
• Import from JSON — Create a new resume from a JSON export directly on the dashboard
• Duplicate & Rename — Quick resume management actions
• Interactive Tours — Step-by-step onboarding for first-time users

• Bilingual UI — Full Chinese (zh) and English (en) interface
• Dark Mode — Light, dark, and system theme support
• Flexible Auth — Google OAuth or browser fingerprint (zero-config)
• Dual Database — SQLite (default, zero-config) or PostgreSQL

# Generate a secret key first
openssl rand -base64 32

docker run -d -p 3000:3000 \
  -e AUTH_SECRET=<your-generated-secret> \
  -v jadeai-data:/app/data \
  twwch/jadeai:latest

Open http://localhost:3000. Database auto-migrates and seeds on first start.

AUTH_SECRET is required for session encryption. Generate one with openssl rand -base64 32.

AI Configuration: No server-side AI env vars needed. Each user configures their own API Key, Base URL, and Model in Settings > AI within the app.

docker run -d -p 3000:3000 \
  -e AUTH_SECRET=<your-generated-secret> \
  -e DB_TYPE=postgresql \
  -e DATABASE_URL=postgresql://user:pass@host:5432/jadeai \
  twwch/jadeai:latest

docker run -d -p 3000:3000 \
  -e NEXT_PUBLIC_AUTH_ENABLED=true \
  -e AUTH_SECRET=your-secret \
  -e GOOGLE_CLIENT_ID=xxx \
  -e GOOGLE_CLIENT_SECRET=xxx \
  -v jadeai-data:/app/data \
  twwch/jadeai:latest

• Node.js 18+
• pnpm 9+

git clone https://github.com/twwch/JadeAI.git
cd JadeAI

pnpm install
cp .env.example .env.local

Edit .env.local:

# Database (defaults to SQLite, no config needed)
DB_TYPE=sqlite

# Auth (defaults to fingerprint mode, no config needed)
NEXT_PUBLIC_AUTH_ENABLED=false

AI Configuration: No server-side env vars needed. Each user configures their own API Key, Base URL, and Model in Settings > AI within the app.

See .env.example for all available options (Google OAuth, PostgreSQL, etc.).

# Generate and run migrations
pnpm db:generate
pnpm db:migrate

# (Optional) Seed with sample data
pnpm db:seed

# Start dev server
pnpm dev

Open http://localhost:3000.

src/
├── app/                        # Next.js App Router
│   ├── [locale]/               # i18n routes (/zh/..., /en/...)
│   │   ├── dashboard/          # Resume list & management
│   │   ├── editor/[id]/        # Resume editor
│   │   ├── preview/[id]/       # Full-screen preview
│   │   ├── templates/          # Template gallery
│   │   └── share/[token]/      # Public shared resume viewer
│   └── api/
│       ├── ai/                 # AI endpoints
│       │   ├── chat/           #   Streaming chat with tool calls
│       │   ├── generate-resume/#   AI resume generation
│       │   ├── jd-analysis/    #   JD match analysis
│       │   ├── grammar-check/  #   Grammar & writing check
│       │   ├── cover-letter/   #   Cover letter generation
│       │   ├── translate/      #   Resume translation
│       │   └── models/         #   List available AI models
│       ├── resume/             # Resume CRUD, export, parse, share
│       ├── share/              # Public share access
│       ├── user/               # User profile & settings
│       └── auth/               # NextAuth handlers
├── components/
│   ├── ui/                     # shadcn/ui base components
│   ├── editor/                 # Editor canvas, sections, fields, dialogs
│   ├── ai/                     # AI chat panel & bubble
│   ├── preview/templates/      # 50 resume templates
│   ├── dashboard/              # Dashboard cards, grid, dialogs
│   └── layout/                 # Header, theme provider, locale switcher
├── lib/
│   ├── db/                     # Schema, repositories, migrations, adapters
│   ├── auth/                   # Auth configuration
│   └── ai/                     # AI prompts, tools, model config
├── hooks/                      # Custom React hooks (7 hooks)
├── stores/                     # Zustand stores (resume, editor, settings, UI, tour)
└── types/                      # TypeScript type definitions

JadeAI includes 50 professionally designed resume templates covering a wide range of styles and industries:

Contributions are welcome! Here's how to get started:

1. Fork the repository
2. Create a feature branch: git checkout -b feat/your-feature
3. Commit your changes: git commit -m 'feat: add your feature'
4. Push to the branch: git push origin feat/your-feature
5. Open a Pull Request

Join the QQ group for discussion and support:

Apache License 2.0