Skip to content

nickmm1/mbg-theme-builder

Repository files navigation

MBG Theme Builder

Day 1 of every MBG salon client onboarding. Migrates the salon's website from WordPress, Squarespace, Wix, or other platforms to Shopify, then installs MBG-opinionated salon theme defaults.

Built specifically for salons. Companion plugin to nickmm1/mbg-seo.

The 3-plugin MBG salon lifecycle

Day 1:    /mbg-theme-builder         Migrate or greenfield-build Shopify store   [THIS PLUGIN]
Day 2-7:  /mbg-seo                   Full SEO optimization + audit
Day 3:    /mbg-content-generator     Initial 7-25 blogs + 7-25 local pages (sub-skill of /mbg-seo, tiered)
Day 30+:  /mbg-content-engine        Monthly ongoing blog production (Claude Code session per salon)
Day 90:   /mbg-content-optimizer     90-day refresh + expand based on real data (sub-skill of /mbg-seo)

Three plugins, three jobs:

Two flows: migration vs greenfield

Migration flow (existing site → Shopify):
  /mbg-theme-builder Insync https://oldsite.com
  → 6-10 hours focused work

Greenfield flow (no existing site, build from intake):
  /mbg-intake-from-transcript NewSalon ~/Downloads/discovery-call.txt
  /mbg-theme-builder NewSalon --mode=greenfield
  → 4-6 hours focused work (no migration overhead)

Hybrid flow (migrate what's good, build from intake for the rest):
  /mbg-intake-from-transcript SomeSalon ~/Downloads/intake-doc.md
  /mbg-theme-builder SomeSalon --mode=hybrid https://oldsite.com
  → 7-11 hours focused work

Greenfield is the v1.1.0 addition. Use it for:

  • Brand new salons with no website history
  • Existing salons whose current site is too broken or off-brand to migrate from
  • Sales-call → Shopify store in under 24 hours

What this plugin does

A new salon comes to MBG either with an existing website (WordPress, Squarespace, Wix, custom, etc.) OR with no website at all. After 4-10 hours of focused work, the team delivers a fully-built Shopify store with:

  • All public content migrated (pages, blog articles, products, team)
  • All image assets transferred to Shopify's CDN with alt text preserved
  • MBG-opinionated salon theme installed (booking-focused, schema-rich, mobile-first)
  • Domain transferred (or aliased) with SSL provisioned
  • 301 redirects from every old URL to the new Shopify URL
  • Booking platform integrated (Boulevard / Vagaro / GlossGenius / Square / Acuity / StyleSeat / Booksy)
  • Retail catalog scaffolded (drop-ship integrations ready)
  • Salon brand voice rules saved to store metafields
  • Handoff documentation ready for /mbg-seo on Day 2

Time per salon: 6-10 hours focused work. API cost per salon: $8-20.

For comparison, equivalent migration via an agency typically costs $3,000-15,000.

Skills included (11)

Skill Phase Purpose
mbg-theme-builder Flagship The 12-phase salon Shopify buildout SOP (migration / greenfield / hybrid)
mbg-intake-from-transcript Pre-Day 1 Parse a discovery call / Otter / Typeform / brain dump into intake.json (greenfield input)
mbg-migrate-wordpress Phase 1 (WP) WordPress → Shopify content migration
mbg-migrate-squarespace Phase 1 (SS) Squarespace → Shopify migration
mbg-migrate-wix Phase 1 (Wix) Wix → Shopify (the hardest one, honestly)
mbg-migrate-generic Phase 1 (other) Webflow, GoDaddy, custom HTML, etc.
mbg-image-migration Phase 2 Bulk image transfer to Shopify CDN
mbg-shopify-setup Phase 3 Foundational store config (theme, payments, taxes, etc.)
mbg-salon-defaults Phase 4 MBG-opinionated salon theme defaults
mbg-content-import Phase 5 Bulk content import via Admin API (skipped in greenfield)
mbg-domain-migration Phase 8-9 Domain transfer + SSL + 301 redirects

Reference docs

  • references/booking-integrations.md — Boulevard, Vagaro, GlossGenius, Square, Acuity, StyleSeat, Booksy integration snippets
  • references/salon-theme-defaults.md — Theme settings, sections, page templates, performance budget
  • references/policy-templates.md — Refund, Privacy, Terms, Shipping policy templates for salon stores
  • references/intake-schema.md — Full JSON schema for intake.json (greenfield input format)
  • references/transcript-examples.md — Three worked examples showing transcript → intake.json extraction with confidence scoring

Installation (for the team)

claude plugin marketplace add nickmm1/mbg-theme-builder
claude plugin install mbg-theme-builder@nickmm1-mbg-theme-builder

After install:

# Migration (existing site)
/mbg-theme-builder <salon-handle> <old-site-url>

# Greenfield (no existing site, build from intake)
/mbg-intake-from-transcript <salon-handle> <transcript-path>
/mbg-theme-builder <salon-handle> --mode=greenfield

# Hybrid (migrate + supplement from intake)
/mbg-intake-from-transcript <salon-handle> <transcript-path>
/mbg-theme-builder <salon-handle> --mode=hybrid <old-site-url>

The flagship skill walks the team through 12 phases of buildout.

When to use this plugin

  • New MBG client onboarding (most common)
  • Existing salon needs full Shopify rebuild
  • Multi-location chain adding a new location store

When NOT to use:

  • Salon is already on Shopify and just needs SEO optimization → use /mbg-seo directly
  • Migrations of non-salon businesses (this is salon-niche specific)
  • Cross-Shopify store migrations (different workflow; ask Nick)

What this plugin does NOT do

Honest gaps:

  • ❌ Customer order history migration (manual CSV import)
  • ❌ Custom CSS from old themes (recommend redesign in Shopify)
  • ❌ WordPress plugin functionality (use Shopify-native equivalents)
  • ❌ Wix Velo apps (rebuild from scratch in Shopify)
  • ❌ Complex multi-platform setups (escalate to Nick)
  • ❌ Domain transfers when owner can't access their registrar

What this plugin requires

  • Shopify Admin API token for the new store
  • Apify API key (for site scraping)
  • Salon owner's brand assets (logo, colors, fonts, photos)
  • Salon's intake doc (services, pricing, team, hours, NAP)
  • 6-10 hours of focused team time per salon

Companion plugins

License

Proprietary. Mirabella Business Group internal use only.

Author

Nick Mirabella nick@nickmirabella.com https://nickmirabella.com

About

MBG salon Shopify buildout + migration playbook (Day 1 of onboarding)

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors