Build, preview, and deploy the VisaJobs.xyz Eleventy site. Use when the user asks to build, deploy, push, preview the site, run the dev server, or fix build errors.
Scanned 9/1/2026
Install to Claude Code
npx -y skills add relocate-with-us/relocate-with-us.github.io --skill site-deploy --agent claude-codeInstalls into .claude/skills of the current project.
Are you the author of Site Deploy?
Add the live security badge to your README — it updates automatically with every re-scan.
[](https://www.skillsdirectory.com/skills/relocate-with-us-site-deploy)More formats (shields.io, HTML) on the badges page.
---
name: site-deploy
description: Build, preview, and deploy the VisaJobs.xyz Eleventy site. Use when the user asks to build, deploy, push, preview the site, run the dev server, or fix build errors.
---
# Build & Deploy VisaJobs.xyz
## Tech Stack
- **Generator**: Eleventy 3.x (config: `.eleventy.js`)
- **Styling**: Tailwind CSS 3.4 (config: `tailwind.config.js`)
- **Templates**: Nunjucks (`.njk`) in `src/`
- **Search**: Pagefind (post-build indexing)
- **Hosting**: GitHub Pages (repo: `relocate-with-us/relocate-with-us.github.io`)
- **Domain**: visajobs.xyz (CNAME file)
## Project Structure
```
src/
├── _data/ # Global data (jobs.json, companies.json, site.json)
├── _includes/
│ ├── layouts/ # base.njk
│ └── partials/ # header, footer, newsletter
├── assets/
│ ├── css/input.css
│ └── js/main.js
├── index.njk # Home page
├── visa-sponsored-jobs/ # Main job listing
├── relocation-jobs/ # Relocation-focused listing
├── blog/ # Markdown blog posts
├── resources/ # Country guides, tips
└── tools/ # Visa checker, salary calc, etc.
media/ # Company logos (passthrough copied)
favicon/ # Favicons
```
## Commands
### Install dependencies
```bash
npm install
```
### Development server
```bash
npx @11ty/eleventy --serve
```
### Production build
```bash
npx @11ty/eleventy
```
Build output: `_site/`
### Build Tailwind CSS
```bash
npx tailwindcss -i src/assets/css/input.css -o _site/assets/css/styles.css
```
### Run Pagefind indexing (after build)
```bash
npx pagefind --site _site
```
## Deploy (GitHub Pages)
The site auto-deploys on push to main via GitHub Pages.
```bash
git add -A
git commit -m "description of changes"
git push origin main
```
### Remote URL
Currently HTTPS. To switch to SSH (avoids token prompts):
```bash
git remote set-url origin git@github.com:relocate-with-us/relocate-with-us.github.io.git
```
## Key Config Notes
- `.eleventy.js` copies `src/_data/jobs.json` to `_site/db.json` after build (legacy compatibility)
- `src/_data/site.json` holds site metadata, social links, analytics IDs
- Google Analytics: `G-E6NMFQFHMZ`
- AdSense: `ca-pub-7578309605540082`
- Grow.me/Mediavine Journey script is in `base.njk` `<head>`
## Common Issues
| Issue | Fix |
|-------|-----|
| Styles missing | Run Tailwind build before/alongside Eleventy |
| Search broken | Run Pagefind after Eleventy build |
| db.json stale | Rebuild — it's auto-copied from jobs.json |
| Push needs token | Switch remote to SSH (see above) |
Is this your skill, or is something wrong with this listing? Request removal or report an issue. Author removals are honored within 72 hours.
No comments yet. Be the first to comment!