Back to Reactive Resume

README

README.md

5.3.010.8 KB
Original Source
<div align="center"> <a href="https://rxresu.me"> </a> <h1>Reactive Resume</h1> <p>Reactive Resume is a free and open-source resume builder that makes it easy to create, update, and share your resume.</p> <p> <a href="https://rxresu.me"><strong>Get Started</strong></a> · <a href="https://docs.rxresu.me"><strong>Learn More</strong></a> </p> <p>
<a href="https://discord.gg/aSyA5ZSxpb"></a>
<a href="https://crowdin.com/project/reactive-resume"></a>
<a href="https://github.com/sponsors/AmruthPillai"></a>
<a href="https://opencollective.com/reactive-resume/donate"></a>
</p> </div>

Pick a template, fill in your details, and export to PDF. Basic use needs no account. If you want more control, you can run the whole application on your own infrastructure.

You own your data. The codebase is open source under the MIT license, with no tracking, no ads, and no hidden costs.

Features

Resume Building

  • Live preview as you type
  • Multiple export formats (PDF, JSON, DOCX)
  • Drag-and-drop section ordering
  • Custom sections for any content type
  • Rich text editor

Templates

  • 15 templates to choose from
  • A4 and Letter page sizes
  • Customizable colors, fonts, and spacing
  • Structured Style Rules for section and text styling

Privacy & Control

  • Self-host on your own infrastructure
  • No tracking or analytics by default
  • Full data export at any time
  • Delete your data permanently with one click

Extras

  • AI integration (OpenAI, Google Gemini, Anthropic Claude)
  • Multi-language support
  • Share resumes via unique links
  • Import from JSON Resume format
  • Dark mode
  • Passkey and two-factor authentication

Templates

<table> <tr> <td align="center">

<sub><b>Azurill</b></sub> </td> <td align="center">

<sub><b>Bronzor</b></sub> </td> <td align="center">

<sub><b>Chikorita</b></sub> </td> <td align="center">

<sub><b>Ditto</b></sub> </td>

</tr> <tr> <td align="center">

<sub><b>Gengar</b></sub> </td> <td align="center">

<sub><b>Glalie</b></sub> </td> <td align="center">

<sub><b>Kakuna</b></sub> </td> <td align="center">

<sub><b>Lapras</b></sub> </td>

</tr> <tr> <td align="center">

<sub><b>Leafish</b></sub> </td> <td align="center">

<sub><b>Onyx</b></sub> </td> <td align="center">

<sub><b>Pikachu</b></sub> </td> <td align="center">

<sub><b>Rhyhorn</b></sub> </td>

</tr> <tr> <td align="center">

<sub><b>Ditgar</b></sub> </td> <td align="center">

<sub><b>Meowth</b></sub> </td> <td align="center">

<sub><b>Scizor</b></sub> </td>

</tr> </table>

Quick Start

The quickest way to run Reactive Resume locally:

bash
# Clone the repository
git clone --depth=1  https://github.com/amruthpillai/reactive-resume.git
cd reactive-resume

# Start all services
docker compose up -d

# Access the app
open http://localhost:3000

For detailed setup instructions, environment configuration, and self-hosting guides, see the documentation.

Tech Stack

CategoryTechnology
FrameworkTanStack Start (React 19, Vite)
RuntimeNode.js
LanguageTypeScript
DatabasePostgreSQL with Drizzle ORM
APIORPC (Type-safe RPC)
AuthBetter Auth
StylingTailwind CSS
UI ComponentsBase UI + shadcn-style package
State ManagementZustand + TanStack Query

Documentation

The full documentation lives at docs.rxresu.me:

GuideDescription
Getting StartedFirst-time setup and basic usage
Self-HostingDeploy on your own server
Development setupLocal development environment
Project architectureCodebase structure and patterns
Exporting Your ResumePDF and JSON export options

Self-Hosting

Reactive Resume can be self-hosted using Docker. The stack includes:

  • PostgreSQL — Database for storing user data and resumes
  • SeaweedFS (optional) — S3-compatible storage for file uploads

From v5.1.0 onwards — PDF generation runs entirely client-side via @react-pdf/renderer. New deployments no longer need Browserless, Chromium, or any external print service. The PRINTER_* and BROWSERLESS_* environment variables are no longer read and can be removed from your .env.

Pull the latest image from Docker Hub or GitHub Container Registry:

bash
# Docker Hub
docker pull amruthpillai/reactive-resume:latest

# GitHub Container Registry
docker pull ghcr.io/amruthpillai/reactive-resume:latest

See the self-hosting guide for complete instructions.

Support

Reactive Resume is and always will be free and open source. If it has helped you land a job or saved you time, please consider supporting continued development:

<p> <a href="https://github.com/sponsors/AmruthPillai"> </a> <a href="https://opencollective.com/reactive-resume/donate"> </a> </p>

Other ways to support:

  • Star this repository
  • Report reproducible bugs and suggest actionable features
  • Help other users in GitHub Discussions
  • Improve documentation
  • Help with translations

Star History

<a href="https://www.star-history.com/?repos=amruthpillai%2Freactive-resume&type=date&legend=top-left"> <picture> <source media="(prefers-color-scheme: dark)" srcset="https://api.star-history.com/chart?repos=amruthpillai/reactive-resume&type=date&theme=dark&legend=top-left&sealed_token=QmaOn4Ech499R6kpQe8ONn911UjGUaJfQBT0MXlQLU9hTo-Ie7lTxIILWbBvmtzDGHk7ziWKN_N5iM5mgP8widn_FGHd9-PHNokPtSji8XLgbFpqatgyqIDPnOys-IhO40W3J0HeH07FL-Q8Bq6ArRk3LDtJDwjh4m0ya-2L59ULb7BaqxkSDuCytkCr" /> <source media="(prefers-color-scheme: light)" srcset="https://api.star-history.com/chart?repos=amruthpillai/reactive-resume&type=date&legend=top-left&sealed_token=QmaOn4Ech499R6kpQe8ONn911UjGUaJfQBT0MXlQLU9hTo-Ie7lTxIILWbBvmtzDGHk7ziWKN_N5iM5mgP8widn_FGHd9-PHNokPtSji8XLgbFpqatgyqIDPnOys-IhO40W3J0HeH07FL-Q8Bq6ArRk3LDtJDwjh4m0ya-2L59ULb7BaqxkSDuCytkCr" /> </picture> </a>

Contributing

Every contribution helps, whether it is a typo fix or a new feature.

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

See the development setup guide for how to run the project locally.

Maintainers review the status: needs triage queue weekly. Triaged bugs become status: confirmed; feature proposals become status: accepted; reports that need details become status: needs info.

License

MIT — do whatever you want with it.