create-cv-tailor

create-cv-tailor

Create a private React-PDF workspace for tailoring a CV to job descriptions with traceable project evidence.

npx create-cv-tailor my-cv

The setup asks for a package manager, dependency installation, and Git initialization. To copy an existing CV into the project, pass it with --source-pdf:

npx create-cv-tailor my-cv --yes --source-pdf ./resume.pdf

Requires Node.js 20 or newer.

Privacy model

The public package contains only fictional examples under src/examples/. A generated workspace keeps most personal material in separate Git-ignored paths:

• src/initial-setup/ for the source and base CV
• src/applications/ for job descriptions and tailored CVs
• src/info-for-cv/ for private project evidence. Its _project-list.md registry remains tracked.
• src/job-monitoring/ for job-search data

Generated projects also have "private": true in package.json, which blocks accidental npm publication. Keep the Git repository private anyway. Git ignore rules prevent common mistakes, but they do not encrypt data or remove files that were already committed.

CLI options

create-cv-tailor [directory] [options]

-y, --yes                    Accept the defaults
--package-manager <name>     npm, pnpm, yarn, or bun
--source-pdf <path>          Copy an existing CV into the project
--no-install                 Skip dependency installation
--no-git                     Skip Git initialization
-h, --help                   Show help
-v, --version                Show the package version

The generator refuses to overwrite a non-empty directory and checks that a supplied source file starts with a PDF header.

Generated project commands

npm run check          # Validate the configured source, output, and optional source PDF
npm run build          # Render the active React-PDF CV
npm run watch          # Rebuild when TSX files change
npm run privacy:check  # Fail if personal-data paths are tracked by Git
npm run validate       # Run the checks and build together

The active source and output paths are stored in scripts/build/buildConfig.ts. Both paths must be relative to the project, the source must exist, and the output must end in .pdf.

CV workflow

• Add a source CV under src/initial-setup/.
• Follow docs/cv/initial-setup.md to choose a design, register project sources, add the first job description, collect evidence, and create base-cv.tsx.
• Follow docs/cv/tailoring.md for each application.
• Point buildConfig.ts at the active TSX file and run npm run validate.

AGENTS.md routes agents to the setup, evidence, and tailoring instructions under docs/cv/. Fictional CVs and project notes demonstrate the expected structure without mixing sample claims with private data.

Develop the package

npm install
npm test
npm run validate
npm pack --dry-run

The package has no runtime dependencies. React, React-PDF, and the TypeScript runner are installed in each generated workspace.

License

MIT