Skip to content

idimetrix/cv

Repository files navigation

Professional CV Maker

🎯 Professional CV Maker

Create stunning, ATS-friendly CVs in minutes

Deploy with Vercel License: MIT pnpm

Live Demo Β· Report Bug Β· Request Feature


🌟 Why Choose This CV Maker?

A modern, minimalist CV builder designed for professionals who value simplicity and results. Built with the latest web technologies, this tool creates beautiful, print-friendly CVs that actually get past Applicant Tracking Systems (ATS).

Perfect for:

  • πŸ’Ό Job seekers wanting a professional online presence
  • πŸŽ“ Recent graduates building their first CV
  • πŸ‘¨β€πŸ’» Developers showcasing their technical skills
  • πŸš€ Professionals who need quick, reliable CV generation
  • 🏒 Organizations managing CVs for multiple team members
  • 🌐 Platforms hosting CVs for 1000+ users

✨ Key Features

🎨 Beautiful Design

  • Clean, minimalist layout that highlights your experience
  • Responsive design works perfectly on all devices
  • Print-friendly formatting for physical copies

⚑ Lightning Fast Setup

  • Configure everything in a single file
  • No complex forms or databases required
  • Live preview as you make changes

πŸ€– ATS-Optimized

  • Passes Applicant Tracking Systems with ease
  • Semantic HTML structure for better parsing
  • SEO-optimized for maximum online visibility

πŸ› οΈ Developer-Friendly

  • Built with modern tech stack (React, Next.js, TypeScript)
  • Fully customizable and extensible
  • Type-safe development experience

πŸ“€ Export Options

  • Print directly from browser
  • Download as PDF
  • Export as PNG, JPG, or SVG
  • Share via unique URL

πŸ‘₯ Multi-User Support

  • Support for unlimited users (tested with 1000+)
  • Dynamic loading - only loads data when needed
  • Each user gets their own URL: /user/{username}
  • API endpoints for user management
  • Scales effortlessly with your needs

πŸš€ Tech Stack

Frontend

  • βš›οΈ React 19
  • β–² Next.js 15
  • πŸ“˜ TypeScript 5
  • 🎨 Tailwind CSS 4

Tooling

  • πŸ“¦ pnpm Workspaces
  • πŸ”₯ Turbo (Monorepo)
  • 🎯 ESLint 9
  • ✨ Prettier 3

Deployment

  • β–² Vercel (Recommended)
  • 🐳 Docker Support
  • πŸ”„ CI/CD Ready
  • πŸ“Š Analytics Built-in

πŸƒ Quick Start

Get your CV up and running in less than 5 minutes:

# Clone the repository
git clone https://github.com/idimetrix/cv.git

# Navigate to the project
cd cv

# Install dependencies and setup
pnpm bootstrap

# Start the development server
pnpm web:dev

πŸŽ‰ That's it! Open http://localhost:3000 to see your CV.

πŸ‘₯ Adding More Users

Want to host multiple CVs? Check out the Multi-User Guide for detailed instructions.

# Quick: Create a new user
mkdir apps/web/users/johndoe
cp -r apps/web/users/idimetrix/* apps/web/users/johndoe/

# Edit the user data
# Then add to apps/web/utils/users.ts

# Access at http://localhost:3000/user/johndoe

πŸ“– Detailed Setup Guide

Prerequisites

Before you begin, ensure you have:

Step-by-Step Installation

1️⃣ Clone the Repository

git clone https://github.com/idimetrix/cv.git
cd cv

2️⃣ Install Dependencies

pnpm install
# or use the bootstrap command for full setup
pnpm bootstrap

The bootstrap command will:

  • Install all dependencies
  • Run code formatters (Prettier)
  • Run linters (ESLint)
  • Type-check the codebase

3️⃣ Configure Your CV

Edit the configuration file at:

apps/web/users/idimetrix/index.ts

Or create your own profile folder:

apps/web/users/your-name/

4️⃣ Start Development

pnpm web:dev

Your CV will be available at http://localhost:3000


🎯 Customization Guide

Basic Configuration

All your CV content is managed in a single configuration file:

// apps/web/users/idimetrix/index.ts
export const RESUME = {
  firstName: "Your",
  lastName: "Name",
  email: "your.email@example.com",
  phone: "+1234567890",
  // ... more fields
};

Key Sections to Customize:

  1. Personal Information - Name, contact, location
  2. Professional Summary - Your elevator pitch
  3. Experience - Work history with achievements
  4. Education - Academic background
  5. Skills - Technical and soft skills
  6. Projects - Portfolio pieces
  7. Languages - Language proficiency

Advanced Customization

  • Styling: Modify tailwind.config.js for theme changes
  • Layout: Edit components in apps/web/components/
  • SEO: Update metadata in apps/web/utils/seo.tsx

πŸ“œ Available Scripts

Development

pnpm web:dev        # Start development server
pnpm web:build      # Build for production
pnpm web:start      # Start production server

Code Quality

pnpm format         # Format, lint, and type-check
pnpm lint           # Run ESLint
pnpm type           # Run TypeScript type checking
pnpm prettier       # Format code with Prettier

Maintenance

pnpm clean          # Clean build artifacts and node_modules
pnpm bootstrap      # Fresh install and setup

πŸš€ Deployment

Deploy to Vercel (Recommended)

The easiest way to deploy your CV:

Deploy with Vercel

Or manually:

# Install Vercel CLI
npm i -g vercel

# Deploy
vercel

Other Platforms

Deploy to Netlify
# Build the project
pnpm web:build

# Deploy the .next folder
netlify deploy --prod --dir=apps/web/.next
Deploy with Docker
# Build Docker image
docker build -t cv-app .

# Run container
docker run -p 3000:3000 cv-app

πŸ“ Project Structure

cv/
β”œβ”€β”€ apps/
β”‚   └── web/                    # Main Next.js application
β”‚       β”œβ”€β”€ components/         # React components
β”‚       β”‚   β”œβ”€β”€ atoms/         # Basic UI elements
β”‚       β”‚   β”œβ”€β”€ molecules/     # Composite components
β”‚       β”‚   └── organism/      # Page-level components
β”‚       β”œβ”€β”€ constants/         # Configuration & constants
β”‚       β”œβ”€β”€ pages/             # Next.js pages
β”‚       β”‚   β”œβ”€β”€ index.tsx      # Homepage (default user)
β”‚       β”‚   β”œβ”€β”€ user/          # Multi-user routes
β”‚       β”‚   β”‚   └── [username].tsx  # Dynamic user pages
β”‚       β”‚   └── api/           # API endpoints
β”‚       β”‚       └── users/     # User API
β”‚       β”œβ”€β”€ styles/            # Global styles
β”‚       β”œβ”€β”€ types/             # TypeScript types
β”‚       β”œβ”€β”€ users/             # User CV data ⭐ Multi-user support
β”‚       β”‚   β”œβ”€β”€ idimetrix/     # Example user
β”‚       β”‚   └── {username}/    # Add more users here
β”‚       └── utils/             # Utility functions
β”‚           └── users.ts       # User management utilities
β”œβ”€β”€ packages/                   # Shared packages
β”‚   β”œβ”€β”€ config/                # Shared configuration
β”‚   β”œβ”€β”€ dayjs/                 # Date utilities
β”‚   β”œβ”€β”€ lib/                   # Shared utilities
β”‚   β”œβ”€β”€ mongodb/               # Database utilities
β”‚   β”œβ”€β”€ trpc/                  # API layer
β”‚   └── tsconfig/              # TypeScript configs
β”œβ”€β”€ USERS_GUIDE.md             # Multi-user setup guide ⭐
└── turbo.json                 # Turbo configuration

🀝 Contributing

Contributions are what make the open-source community amazing! Any contributions you make are greatly appreciated.

How to Contribute

  1. Fork the Project
  2. Create your Feature Branch (git checkout -b feature/AmazingFeature)
  3. Commit your Changes (git commit -m 'Add some AmazingFeature')
  4. Push to the Branch (git push origin feature/AmazingFeature)
  5. Open a Pull Request

Development Guidelines

  • Follow the existing code style
  • Write meaningful commit messages
  • Add tests for new features
  • Update documentation as needed
  • Ensure all tests pass before submitting

πŸ“ License

This project is licensed under the MIT License - see the LICENSE file for details.

What this means:

  • βœ… Use commercially
  • βœ… Modify freely
  • βœ… Distribute
  • βœ… Private use
  • ❌ Liability or warranty

πŸ‘¨β€πŸ’» Author

Dmitrii Selikhov


πŸ™ Acknowledgments

  • Inspired by the need for simple, effective CV creation
  • Built with amazing open-source technologies
  • Community feedback and contributions

πŸ“š Resources


πŸ“Š Project Stats

  • ⭐ Stars: Show your support by starring this repo!
  • πŸ› Issues: Found a bug? Report it
  • πŸ’‘ Ideas: Have a feature request? Share it

Made with ❀️ by developers, for developers

If this project helped you, please consider giving it a ⭐

⬆ Back to Top

Releases

No releases published

Packages

No packages published