{"id":29917678,"url":"https://github.com/uixprt/nextjs-cv-builder","last_synced_at":"2026-04-02T18:52:16.809Z","repository":{"id":305062856,"uuid":"1021802992","full_name":"uixprt/nextjs-cv-builder","owner":"uixprt","description":"Interactive CV portfolio built with Next.js, Material-UI \u0026 PDF export support","archived":false,"fork":false,"pushed_at":"2025-07-18T11:52:57.000Z","size":666,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2025-07-18T15:40:24.935Z","etag":null,"topics":["app-router","builder","custom","cv","export","generator","github-actions","github-pages","json","material-ui","nextjs","no-db","pdf","portfolio","print","react","resume","static"],"latest_commit_sha":null,"homepage":"http://cvs.uixprt.com/","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/uixprt.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2025-07-18T01:29:42.000Z","updated_at":"2025-07-18T11:53:01.000Z","dependencies_parsed_at":"2025-07-18T15:46:43.181Z","dependency_job_id":null,"html_url":"https://github.com/uixprt/nextjs-cv-builder","commit_stats":null,"previous_names":["uixprt/cvs","uixprt/nextjs-cv-builder"],"tags_count":1,"template":false,"template_full_name":null,"purl":"pkg:github/uixprt/nextjs-cv-builder","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/uixprt%2Fnextjs-cv-builder","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/uixprt%2Fnextjs-cv-builder/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/uixprt%2Fnextjs-cv-builder/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/uixprt%2Fnextjs-cv-builder/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/uixprt","download_url":"https://codeload.github.com/uixprt/nextjs-cv-builder/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/uixprt%2Fnextjs-cv-builder/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":268338370,"owners_count":24234540,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","status":"online","status_checked_at":"2025-08-02T02:00:12.353Z","response_time":74,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["app-router","builder","custom","cv","export","generator","github-actions","github-pages","json","material-ui","nextjs","no-db","pdf","portfolio","print","react","resume","static"],"created_at":"2025-08-02T05:14:13.775Z","updated_at":"2025-12-30T21:51:47.835Z","avatar_url":"https://github.com/uixprt.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Next.js CV Builder – Dynamic Resume Portfolio\n\nA modern, professional CV builder application built with Next.js, Material-UI, and @react-pdf/renderer. This application displays multiple CV variants and provides both print and PDF export functionality with ATS-friendly, searchable PDFs. \n\n([Live Demo](https://cvs.uixprt.com))\n\n## 🚀 Features\n\n- **Dual CV Profiles**: Switch between different professional profiles (Frontend Engineer \u0026 Senior SDET/Full-Stack)\n- **Real PDF Export**: Generate actual, searchable PDFs using @react-pdf/renderer (not image-based)\n- **Print Functionality**: Clean print layout with optimized CSS for physical printing\n- **Professional Design**: Modern UI with Material-UI components\n- **Static Site Generation**: Optimized for GitHub Pages deployment\n- **TypeScript**: Full type safety for better development experience\n- **Responsive Design**: Works perfectly on all device sizes\n\n## 🛠️ Tech Stack\n\n- **Framework**: Next.js 15 with App Router\n- **Language**: TypeScript\n- **UI Library**: Material-UI (MUI)\n- **PDF Generation**: @react-pdf/renderer\n- **Styling**: MUI\n- **Deployment**: GitHub Pages with GitHub Actions\n\n## 📁 Project Structure\n\n```\nsrc/\n├── app/                    # Next.js app directory\n│   ├── layout.tsx         # Root layout with print styles\n│   └── page.tsx           # Main application page\n├── components/            # React components\n│   ├── CVDisplay.tsx      # Browser CV display (MUI)\n│   ├── CVDocumentPDF.tsx  # PDF template (@react-pdf/renderer)\n│   └── CVHeader.tsx       # Header with controls\n├── data/                  # CV data in JSON format\n│   ├── cv-frontend.json   # Frontend Engineer profile\n│   └── cv-sdet.json       # SDET/Full-Stack profile\n└── types/                 # TypeScript type definitions\n    └── cv.ts              # CV data structure types\n```\n\n## 🎯 Key Technical Solutions\n\n### PDF Export Challenge\nUnlike many solutions that convert HTML to images, this application uses @react-pdf/renderer to create actual, searchable PDFs. This requires maintaining two templates:\n1. **Browser Template** (`CVDisplay.tsx`): Uses MUI components for web display\n2. **PDF Template** (`CVDocumentPDF.tsx`): Uses @react-pdf/renderer primitives for PDF generation\n\n### Static Site Generation\nThe application is configured for static export to work with GitHub Pages:\n- Client-side only PDF generation to avoid SSR issues\n- Optimized build configuration for static hosting\n- Automatic deployment with GitHub Actions\n\n## 🚀 Getting Started\n\n### Prerequisites\n- Node.js 18+ \n- npm, yarn, or pnpm\n\n### Installation\n\n1. Clone the repository:\n```bash\ngit clone git@github.com:uixprt/nextjs-cv-builder.git\ncd nextjs-cv-builder\n```\n\n2. Install dependencies:\n```bash\nnpm install\n```\n\n3. Start the development server:\n```bash\nnpm run dev\n```\n\n4. Open [http://localhost:3000](http://localhost:3000) in your browser\n\n### Building for Production\n\n```bash\nnpm run build\n```\n\nThis creates an optimized static build in the `out/` directory, ready for deployment.\n\n## 📊 CV Data Structure\n\nCV data is stored in JSON format with the following structure:\n\n```typescript\ninterface CVData {\n  profile: string;\n  personalInfo: {\n    name: string;\n    location: string;\n    contact: {\n      phone: string;\n      email: string;\n      linkedin: string;\n    };\n  };\n  headline: string;\n  summary: string;\n  skills: {\n    [category: string]: string[];\n  };\n  experience: Experience[];\n}\n```\n\n## 🔧 Customization\n\n### Adding New CV Profiles\n\n1. Create a new JSON file in `src/data/`\n2. Follow the existing data structure\n3. Add the profile to the `profiles` object in `src/app/page.tsx`\n4. Update the profile selector in `CVHeader.tsx`\n\n### Modifying Styles\n\n- **Browser styles**: Edit MUI theme and component styles in the components\n- **PDF styles**: Modify the StyleSheet in `CVDocumentPDF.tsx`\n- **Print styles**: Update CSS in `src/app/layout.tsx`\n\n## 🚀 Deployment\n\nThe project includes GitHub Actions workflow for automatic deployment to GitHub Pages:\n\n1. Push to the `main` branch\n2. GitHub Actions builds and deploys automatically\n3. Enable GitHub Pages in repository settings\n4. Set source to \"GitHub Actions\"\n\n## 🎨 Design Philosophy\n\nThis application follows the engineering principle of \"building the machine that builds the thing\":\n- **Separation of Concerns**: Display logic separated from data\n- **Maintainable Templates**: Both web and PDF templates use the same data structure\n- **Type Safety**: Full TypeScript coverage for reliable development\n- **Professional Output**: ATS-friendly PDFs for job applications\n\n## 📝 License\n\nThis project is open source and available under the [MIT License](LICENSE).\n\n## 🤝 Contributing\n\nContributions are welcome! Please feel free to submit a Pull Request.\n\n---\n\nBuilt with ❤️ by [Asher Indursky](https://www.linkedin.com/in/asherindursky)\n\n## Deploy on Vercel\n\nThe easiest way to deploy your Next.js app is to use the [Vercel Platform](https://vercel.com/new?utm_medium=default-template\u0026filter=next.js\u0026utm_source=create-next-app\u0026utm_campaign=create-next-app-readme) from the creators of Next.js.\n\nCheck out our [Next.js deployment documentation](https://nextjs.org/docs/app/building-your-application/deploying) for more details.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fuixprt%2Fnextjs-cv-builder","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fuixprt%2Fnextjs-cv-builder","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fuixprt%2Fnextjs-cv-builder/lists"}