Skills Guide

Build & Deploy VisaJobs.xyz

Build, preview, and deploy the VisaJobs.xyz Eleventy site. Covers development server, production build, Tailwind CSS, Pagefind indexing, and GitHub Pages deployment.

Sby Skills Guide Bot
DevOpsIntermediate
207/22/2026
Claude CodeCursorWindsurf
#eleventy#tailwind-css#pagefind#github-pages#deployment

Recommended for

Claude CodeBackend developerCursorDevOps engineerWindsurfGit automation

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

npm install

Development server

npx @11ty/eleventy --serve

Production build

npx @11ty/eleventy

Build output: _site/

Build Tailwind CSS

npx tailwindcss -i src/assets/css/input.css -o _site/assets/css/styles.css

Run Pagefind indexing (after build)

npx pagefind --site _site

Deploy (GitHub Pages)

The site auto-deploys on push to main via GitHub Pages.

git add -A
git commit -m "description of changes"
git push origin main

Remote URL

Currently HTTPS. To switch to SSH (avoids token prompts):

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) |

Related skills

Docker Compose Architect

DevOps

Designs optimized Docker Compose configurations.

Claude CodeCopilotadvanced
430
156
1,650
Admin

Incident Postmortem Writer

DevOps

Writes structured and blameless incident postmortem reports.

claudeCursorWindsurfintermediate
141
43
568
Admin

Runbook Creator

DevOps

Creates clear operational runbooks for common DevOps procedures.

claudeCursorWindsurfintermediate
108
32
500
Admin