Make Plumbo Yours In 30 Minutes
Skill level: Beginner · Time: 30 minutes · You need: the site running with npm run dev (Installation)
This page walks through the ten changes almost every site needs, in order. Each step names one file and the exact lines to edit, and links to the page with the details. Save the file and the browser shows the change, config.toml included.
This page shows the files. In the Tina edition you can make the same changes at /admin/, and in the Sanity edition most of them are in the Studio. See What Is Editable In Tina and What Is Editable In Sanity.
-
Name your site and set its address
Open
src/config/config.tomland edit the[site]block:[site]title = "Acme Plumbing"description = "Licensed plumbers for leaks, drains, and water heaters, priced up front."tagline = "Plumbing and drains in Your Town"baseUrl = "https://www.your-domain.com"logoText = "Acme Plumbing"titleis your brand name. The footer copyright and the structured data use it. The homepage’s browser title comes frommetaTitleinsrc/content/homepage/english/-index.md; change it there.taglineis added to every page title (<page> - <tagline>), so make it a short line about your business. Ataglineordescriptionset here is used for every language. Leave them empty to use each language’s own, insrc/i18n/<lang>.json.baseUrlis your live address. The theme ships with the placeholderhttps://example.com, andnpm run buildprints a[site]warning until you change it. Canonical links, the sitemap,robots.txt, RSS feeds,llms.txt, and social previews all use it.
Details: Config Reference.
-
Add your business details
Your company details live in one place,
[business]in the same file. The header, footer, contact page, area pages, booking form, and the structured data search engines read all use them:[business]name = "" # empty uses site.titletype = "Plumber" # schema.org type; the comment in the file lists the others[business.address]show = true # false = you visit customers and have no public addressstreet = "12 Example Road"locality = "Your Town"region = "ST"postalCode = "00000"country = "US"Every value marked
# samplein the file is a placeholder: the shipped email is[email protected]. Details: Business Info. -
Set your phone number and opening hours
Still in
[business]:[business]phone = "+15550100199" # digits with country code, for tap-to-call linksphoneDisplay = "(555) 010-0199" # how the number is showntimezone = "America/New_York" # for "Open now" and booking datesclosedDates = ["2026-12-25", "2027-01-01"][business.hours]mon = "07:30-18:00"sat = "08:00-14:00"sun = "" # empty = closedThe shipped number is a fictional
555number: replace it. Leavephoneempty to hide every call link. Hours use the 24-hour clock, and"08:00-12:00,13:00-17:00"gives a lunch break. A wrong value prints a[business]warning in the terminal and is ignored, so watch the terminal after you save. -
Set your services and prices
Prices are not typed into pages. They come from one file,
src/content/pricing/english/-index.md, which feeds the estimator, the booking form, the rate sheet, the add-ons, and the “from” prices on service cards. Each service has one rate card, priced by the hour or per unit:rateCards:- id: "pipe-repair"label: "Pipe repair"mode: "hourly" # hourly | unitshourlyRate: 115 # samplecallOutFee: 89 # sample, added once per visithours: { min: 1, max: 8, step: 0.5, default: 2 }- id: "drain-cleaning"label: "Drain cleaning"mode: "units"unit: { one: "drain", other: "drains" }base: 79 # sampleperUnit: 50 # sampleunits: { min: 1, max: 6, step: 1, default: 1 }The yearly maintenance plans are in the same file, under
plansSection.Every number in this file is a sample: replace them all with your own rates. Copy the same numbers into the file of every other language, such as
src/content/pricing/french/-index.md:npm run buildwarns when they differ. The currency iscurrencyunder[settings.estimator]inconfig.toml(defaultUSD).The services themselves are one file each in
src/content/services/english/, with what each visit includes. Details: Pricing & Estimator and Services & What’s Included. -
Replace the sample service areas
The four areas in
src/content/areas/english/(North Harbor, Elm Park, Westfield Heights, Old Mill) are fictional. Rename one file per real area and set its postal codes:title: "North Harbor"zips: ["55501", "55502", "55503"] # sampleneighborhoods:- "Harbor Point"The area finder matches visitors against
zips,neighborhoods, andaliases; the booking form checks the postal code againstzips. The footer areas column lists your area files on its own. The header Areas menu is a plain list: update its links and the count in All areas (4) in eachsrc/config/menu.<language>.json. If your postal codes are not 5 digits, changezipPatternunder[settings.booking]inconfig.toml(the comment there has a UK example). Details: Service Areas. -
Set your brand colors
Open
src/styles/theme.css. The light colors are in the:rootblock, and the dark-mode colors in the:root.darkblock below it::root {--theme-primary: #c2410c; /* text orange: links, icons, checks */--theme-accent: #cf4510; /* pill buttons */--theme-deep: #cf4510; /* the orange block: stats band, emergency band */--theme-forest: #0f1e33; /* navy: dark blocks and dark footers */}Change the matching lines in
:root.darktoo, then check both modes with the light/dark button in the header. Details: Colors & Fonts. -
Add your logo
Plumbo draws a built-in mark (an orange tile with a white water drop) next to
logoText. To use your own logo file instead, put it inpublic/orsrc/assets/images/and set it in[site]:[site]logo = "/images/my-logo.svg"logoText = "" # empty if your logo already has the name in itlogoWidth = "116px" # your logo's width at 28 px talllogoHeight = "28px"Then set
[site.favicon] imageto a square version of your logo and, withnpm run devrunning, runnpm run generate-favicons. Details: Site Identity & Logo. -
Connect the forms
The contact form and the booking form post to a placeholder address until you change it in
config.toml. The dev server shows a warning inside each form, andnpm run devandnpm run buildprint a[forms]line, until you do:[settings]contactFormProvider = "formsubmit.co" # formsubmit.co | formspree | netlify[settings.booking]formAction = "" # empty sends booking requests to contactFormActionThe newsletter sign-up needs your Mailchimp address in
formActionunder[settings.subscription]. Details: Forms and Booking Request. -
Replace the photos
The sample photos are in
src/assets/images/, grouped by area (heroes/,services/,areas/,projects/,team/, and so on). Content files point at them with paths that start with/images/:image: "/images/services/leak-detection.jpg"imageAlt: "Your own description of the photo"Put your own photo in the same folder and change the path and the alt text, in every language folder.
IMAGE-CREDITS.mdlists every sample photo, so you can tick them off. Details: Icons & Images. -
Check, build, and deploy
Stop the dev server and run:
Terminal window npm run astro-checknpm run buildFix anything
astro-checkreports. Read the yellow lines in the build output:[site]meansbaseUrlis still the placeholder (step 1),[forms]means a form still posts to a placeholder (step 8), and[pricing]means the price files of your languages differ (step 4). Then follow the Deployment guide, which has the full launch checklist.
What Next?
- Pick your homepage: Plumbo has four (
/,/home-residential/,/home-water/,/home-commercial/). See Homepages. - Only need English? See Internationalization.
- Point the header button and menus at your pages, and hide the Pages demo menu: Header and Menus.
- Replace the demo content page by page: Pages lists every page and its file. Update the coupons and financing terms on
/specials/: Emergency & Specials. - Replace the sample reviews and projects: Reviews & Projects.
- Try the other layouts of your sections: Section Layouts.
- Let an AI assistant do the repetitive work: Prompt Library.