|
| 1 | +# Simple Resume Template |
| 2 | + |
| 3 | +A fast, responsive, SEO-friendly single‑page resume website powered by React, TypeScript, Tailwind CSS, Vite, and Static Site Generation (SSG). |
| 4 | + |
| 5 | +## Demo & Screenshot |
| 6 | + |
| 7 | +- Live demo: TBD |
| 8 | +- Screenshot:  |
| 9 | + |
| 10 | +## Features |
| 11 | + |
| 12 | +- React + TypeScript responsive single‑page app |
| 13 | +- Content is driven by a single JSON file for easy customization |
| 14 | +- Static Site Generation (SSG) for fast first paint and SEO |
| 15 | +- GitHub Actions for CI and GitHub Pages deployment |
| 16 | +- Formatter & linter with pre‑commit hooks |
| 17 | + |
| 18 | +## Getting Started |
| 19 | + |
| 20 | +1. Make a new repo by clicking "Use this template" |
| 21 | +2. Content: edit `site-data.json` |
| 22 | +3. Profile image: replace `public/profile.jpeg` with your own profile image (200×200 recommended) |
| 23 | +4. Style: edit Tailwind styles in `src/style.css` and within component files as needed |
| 24 | + |
| 25 | +### Recommended: Generate `site-data.json` using AI from LinkedIn |
| 26 | + |
| 27 | +1. LinkedIn Profile > More > Save as PDF |
| 28 | +2. Download [site-data.json](./site-data.json) |
| 29 | +3. Upload both files to your favorite AI and ask it to generate a `site-data.json` file tailored to you! |
| 30 | + |
| 31 | +## Project Structure |
| 32 | + |
| 33 | +- `index.html`: main html file |
| 34 | +- `src/`: react components and app entry |
| 35 | +- `public/`: static assets like profile image |
| 36 | +- `site-data.json`: all content for the site |
| 37 | +- `dist/`: generated site output (not committed) |
| 38 | + |
| 39 | +## Scripts |
| 40 | + |
| 41 | +- `npm run dev`: start local dev server |
| 42 | +- `npm run build`: build static site with SSG |
| 43 | +- `npm run preview`: preview built output |
| 44 | +- `npm run lint`: check formatting/lint with Biome |
| 45 | +- `npm run lint:fix`: auto‑format and fix with Biome |
| 46 | + |
| 47 | +## Deployment |
| 48 | + |
| 49 | +### GitHub Pages |
| 50 | +1) Ensure the repository has Pages enabled under Settings → Pages, with source “GitHub Actions”. |
| 51 | +2) The included workflow `.github/workflows/deploy.yml` builds and deploys on pushes to `main`. |
| 52 | +3) Push to `main`. The site will publish to the Pages URL shown in the workflow output. |
| 53 | +4) Optionally, set up a custom domain under Settings → Pages. |
| 54 | + |
| 55 | +### Other static hosts |
| 56 | +- Netlify, Vercel, Cloudflare Pages: configure a project that runs `npm run build` and serves the `dist/` directory. |
| 57 | + |
| 58 | +## Contribution Guidelines |
| 59 | + |
| 60 | +We welcome improvements! Please see `CONTRIBUTING.md` for coding style, branch/PR process, and local setup. Highlights: |
| 61 | +- Use Node.js as defined in `.nvmrc`. |
| 62 | +- Before committing, run `npm run lint:fix`. |
| 63 | +- Keep components small and typed; prefer descriptive prop types. |
| 64 | + |
| 65 | +## License |
| 66 | + |
| 67 | +[MIT](https://wei.mit-license.org/) |
0 commit comments