THE 100 CLUB · STUDIO GUIDE
All HTML guides Studio Help

Studio guide (HTML)

Edit live sites

Readable in the browser. Use Print / Save PDF for a PDF copy. Source.md stays on PC for editing only.

Studio / IT Updated 2026-08-06 No secrets

How to edit live brand sites (Studio)

One page for IT / Studio. Full QOL plan: PLAN-STUDIO-QOL.md.

Which mode am I in?

Badge / pillMeaningWhat you do
Exact files / Exact / liveEditing the real website files (or brand has a live folder)Click text → Save writes live files. Optional: Import site…
Imported draft / ImportedLive folder was copied into Studio pagesEdit in Builder → Publish to live website
Needs importLive folder exists, Studio draft may be empty/oldImport site… first
CMS onlyLab / demo no separate disk siteEdit + Publish inside Studio only

Websites tab shows the same badges on each fleet card.

Safe mental model

  1. Import = copy live folder → Studio draft only. Customers never see this step.
  2. Save (exact mode) = write the real files you’re editing.
  3. Publish to live website = write Studio pages out to the live folder (imported / CMS-live brands).

Never assume Import already updated the live site it does not.

Import wizard (friendly path)

  1. Open Site Builder (cms.html?site=BRAND) or Websites → Builder.
  2. Click Import site… (top bar, banner, or empty-state CTA).
  3. Scan website folder lists HTML pages on disk (title, file, size).
  4. Check the pages you want (or Select all). Enter runs Import when ready.
  5. Import N pages Studio draft is snapshotted first, then progress + report.
  6. Open home in editor edit, then Publish to live website when ready.
  7. Mistake? Undo last import restores Studio drafts only (not live).

Re-import replaces matching Studio draft pages with current disk files. Live still unchanged until Publish.

Draft snapshots: data/cms-snapshots/{brand}/

Brands with real folders

Typically: Mikiki, Moose Mechanical, KJ Cosmetics, 100 Club.

Lab / demo portals are CMS only no Import button.

Publish safety (Q3)

  1. Click Publish to live website.
  2. Confirm: *This updates the LIVE website customers see* backup runs first.
  3. Publish report shows pages written / skipped / failed + backup id.
  4. If something looks wrong: Rollback… (top bar) or Rollback this backup in the report.
  5. Restore picks a snapshot → current live HTML is snapshotted again → files restored.

Backups live on this PC under portal-app/data/publish-backups/{brand}/ (last 12 per brand). HTML pages (+ a few CSS files), not full image libraries.

Save (exact mode) still writes the current page with a small .bak-studio side file. Publish does the full multi-page snapshot.

If something looks wrong

SymptomTry
Import button missingBrand is CMS-only, or wrong site selected in switcher
Scan finds 0 pagesSite folder not linked / empty check nginx brand root
Colors wrong after importWarning in report: no stylesheets re-check head assets
Live site didn’t changeYou only Imported use Publish to live website
Bad publishRollback… → pick newest good backup → Restore
Not sure of modeRead the banner pill + Websites fleet badge
Editor feels broken after updateHard-refresh cms.html · run node scripts/audit-studio-editor.js
Publish backup missingConfirm data/publish-backups/ · health publishBackupsDir

Automated + full smoke

cd Documents\portal-app
node scripts\audit-studio-editor.js

Full brand matrix: SMOKE-STUDIO-EDITOR.md · plan: PLAN-STUDIO-EDITOR-POLISH.md

Studio Ops panel → Editor audit runs the same script while signed in as owner.

Related