- name
- netlify
- description
- Use the Netlify CLI (netlify) to create/link Netlify sites and set up CI/CD (continuous deployment) from GitHub, especially for monorepos (multiple sites in one repo like Hugo sites under sites/<domain>). Use when Avery asks to deploy a new site, connect a repo to Netlify, configure build/publish settings, set environment variables, enable deploy previews, or automate Netlify site creation.
netlify
Use the netlify CLI to create projects (“sites”), link local folders, and configure CI/CD from GitHub.
Pre-reqs
netlify --version- Logged in (
netlify login) or provide--auth $NETLIFY_AUTH_TOKEN. - Know the Netlify team/account slug you want to create sites under (optional but recommended).
Helpful checks:
netlify status
netlify sites:listMonorepo pattern (recommended)
For one repo with multiple sites (e.g. sites/seattlecustomboatparts.com, sites/floridacustomerboatparts.com):
- Create one Netlify site per domain.
- Set the site’s Base directory to that subfolder.
- Put a
netlify.toml*inside that subfolder*.
This keeps each domain’s build config self-contained.
Hugo subfolder netlify.toml
Create sites/<domain>/netlify.toml:
[build]
command = "hugo --minify"
publish = "public"
[build.environment]
HUGO_VERSION = "0.155.1"(Adjust HUGO_VERSION as needed.)
Fast workflow: create + link + init CI/CD
1) Create a Netlify site (project)
Run inside the site folder you want to deploy (base dir):
cd sites/<domain>
netlify sites:create --name <netlify-site-name> --account-slug <team> --with-ciNotes:
--with-cistarts CI hooks setup.- If you need manual control, add
--manual.
2) Link local folder to the created site
If not linked already:
netlify link3) Connect to GitHub for continuous deployment
netlify initThis is usually interactive (select Git remote/repo + build settings). For automation we can pre-create netlify.toml and then accept defaults.
Environment variables
Set per-site vars:
netlify env:set VAR_NAME value
netlify env:listUseful for monorepos:
CONTACT_EMAIL(or other shared config)
Deploy
Manual deploys (handy for quick preview):
netlify deploy # draft deploy
netlify deploy --prod # production deployIncluded scripts
scripts/hugo_netlify_toml.sh: create anetlify.tomlin a Hugo subfolderscripts/netlify_monorepo_site.sh: helper to create/link/init a site for a subfolder
When using scripts, prefer passing NETLIFY_AUTH_TOKEN via env for non-interactive runs.