Skip to content
New: Customize your theme with an AI assistant. Read the guide

Glossary

Plain-language meanings of the words used in these docs.

Theme Words

WordWhat it means
AstroThe tool that turns Plumbo’s files into a website. You don’t need to learn it to edit content
Tailwind CSSThe styling system. Classes like bg-sage or mt-8 in components set colors and spacing
Static siteA website made of ready-made files, with no database or server code to run, so it is simple to host
Node.jsThe program that runs Astro on your computer
npmComes with Node.js. Installs the theme’s tools (npm ci or npm install) and runs its commands (npm run dev)
TerminalA window where you type commands. In VS Code: Terminal → New Terminal
Dev serverThe local copy of your site at http://localhost:4321/ that updates when you save. Started with npm run dev
BuildTurning the files into the finished website in the dist/ folder, with npm run build
DeployPutting the built site on the internet, on a host such as Netlify, Vercel, or Cloudflare Pages
RouteA file in src/pages/ that becomes a page and decides which sections it shows
SectionOne full-width block of a page (hero, plans, FAQ). A component plus a content file
ComponentA .astro file that draws part of the page. You rarely need to edit these
Content fileA .md or .mdx file in src/content/ that holds text and options
MarkdownA simple way to format text: **bold**, ## heading, - list item
MDXMarkdown that can also use components (shortcodes) such as <Callout> or <JobTicket>
ShortcodeA ready-made component you can place inside an .mdx file. /components/ on your local site shows them all
FrontmatterThe settings block between two --- lines at the top of a content file, written in YAML
YAMLThe key: value format used in frontmatter. Indentation matters
TOMLThe key = value format of config.toml, grouped under [tables]
JSONThe "key": "value" format of the menu, language, font, social, and translation files
CollectionA folder of similar entries: services, areas, reviews, projects, job openings, blog posts
EntryOne file in a collection, which usually becomes one page
SlugThe part of the URL that names a page: leak-detection in /services/leak-detection/. Comes from the file name, or customSlug
Named blockA section’s settings written inside a page’s frontmatter, to change that section on that page only
LayoutOne of the looks a section can have, chosen with options.layout. /elements/ previews them
DraftA page with draft: true. It shows on the dev server but is not built
i18nShort for “internationalization”: the multi-language setup
RTLRight to left: the reading direction of languages such as Arabic. Plumbo’s Arabic pages are mirrored
SchemaThe list of fields a content file may have. npm run astro-check and the build report mistakes in files that have one. Section files and the contact page file have none, so check those pages in the browser
LucideThe free icon set Plumbo uses. Any name from lucide.dev/icons works, for example "House" or "Wrench"
Dark modeThe dark color scheme. Visitors switch with the light/dark button; [settings.colorScheme] default sets what they see first
Open Graph imageThe preview picture shown when a link is shared on social media or in chat apps. Plumbo generates one per page
Structured dataHidden JSON-LD in each page that tells search engines about your business, services, areas, and prices
SitemapA list of every page, for search engines (/sitemap-index.xml)
llms.txtA proposed format: a Markdown map of your site, with your business facts first, that AI assistants can read
GitA tool that saves versions of your project, so you can undo any change
CommitOne saved version in git
DiffA view of exactly what changed in a file: removed lines and added lines

Plumbo Words

WordWhat it means
[business]The block in config.toml with your company name, phone, email, address, hours, time zone, and closed dates. Every page reads them from there
Business tokens{name}, {phone}, {email}, {address}, and {hours} in Markdown text and some fields. Plumbo replaces them with the values from [business] (in .md files, not .mdx)
Service-area businessA company that visits customers and has no public address. Set [business.address] show = false to hide the street and postal code everywhere
TradeA group of services: plumbing repairs, drains and sewer, water heaters and water, and 24/7 emergency. Trades are listed under trades: in src/content/services/english/-index.md and group the services page
ServiceOne thing you sell, such as leak detection or a tankless water heater install. One file in src/content/services/
Included / not includedThe lists of tasks each service covers and never covers, by area of the home or job type. Set with included and notIncluded in the service file
Rate cardThe price rule of one service in the price file: by the hour plus a call-out fee (hourly), or per unit such as per drain, fixture, foot, or gallon (units)
Maintenance planA yearly plan on /pricing/, such as a yearly inspection and a water heater flush. Written in plansSection in the price file
Add-onA priced extra, such as a camera inspection or a new shut-off valve, added to a visit
EstimatorThe instant price calculator on the pricing page, service pages, and some heroes. It shows the price from your rate cards; it is not a live quote
TicketThe receipt-style card that shows an estimate, a booking summary, or an area’s details. The estimate ticket has a short code such as EST-4K7Q2
Job ticketA ticket you place in a blog post or page with the <JobTicket> shortcode, for example a checklist with a price
Booking requestThe multi-step form on /book/. It sends a request to your inbox; you confirm the visit yourself
Service areaA town or district you work in. One file in src/content/areas/, with its postal codes (zips), neighborhoods, and local notes, and its own page
Area finderThe box where visitors type a postal code or a neighborhood to see whether you cover it
Commercial sectorA type of business customer, such as restaurants or property managers. One file in src/content/industries/, with its own page under /industries/
GuaranteeThe promise on /guarantee/: a written price and a labour warranty, and a free return visit if a repair fails because of the work. The periods are samples: set your own terms
Mobile action barThe bar at the bottom of phone screens with Call and the header’s main button ([settings.mobileActionBar])
Mega menuThe wide dropdown under Services in the header, with columns of links you write in the menu files
Layout switcherA floating Change layout button for the theme’s demo. Off by default ([settings.layoutSwitcher] enable = false); keep it off on your site
SampleA placeholder fact in the content files, marked # sample: prices, phone, address, reviews, ratings, team members, and photos. Replace each one before you launch
Type something to search...