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 Givo’s files into a website. You don’t need to learn it to edit content
Tailwind CSSThe styling system. Classes like bg-primary 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, causes, 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 <Notice> or <Accordion>
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: causes, events, stories, team members, supporter quotes, job openings
EntryOne file in a collection, which usually becomes one page
SlugThe part of the URL that names a page: clean-water-wells in /causes/clean-water-wells/. 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. Givo’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 Givo uses. Any name from lucide.dev/icons works, for example "HandHeart" or "Droplets"
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. Givo generates one per page
Structured dataHidden JSON-LD in each page that tells search engines about your organization, events, stories, and FAQ
SitemapA list of every page, for search engines (/sitemap-index.xml)
llms.txtA proposed format: a Markdown map of your site, with your organization 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

Givo Words

WordWhat it means
[organization]The block in config.toml with your organization’s name, registration number, phone, email, address, office hours, time zone, and closed dates. Every page reads them from there
Organization tokens{name}, {phone}, {email}, {address}, and {hours} in Markdown text and some fields. Givo replaces them with the values from [organization] (in .md files, not .mdx)
Registration numberYour charity or non-profit number (registrationNumber in [organization]). It shows in the footer and the donation form’s fine print. Empty hides it
CauseOne appeal or program you raise money for, such as clean water wells or a winter shelter. One file in src/content/causes/, with its own page
CategoryA group of causes, such as Education or Clean water. Categories are listed under categories: in src/content/causes/english/-index.md; they make the filter on /causes/ and the groups of the Causes mega menu
Goal, raised, donorsThe three numbers of a cause: the target amount, the amount raised so far, and the number of donors. You type them in the cause file; the site does not count gifts
DeadlineThe optional last day of a cause. The cause shows the days left, “Last day” on the day itself, and “Ended” after it. A cause without a deadline is ongoing
Progress barThe bar that shows how much of the goal is raised. It never goes past 100%
Donation formThe form on /donate/ with amounts, one-time or monthly giving, a cause picker, the donor’s details, and an impact receipt. It sends the gift to your payment provider; the site never handles card details
Quick donateThe short donation panel on the main homepage: frequency, preset amounts, and a button that opens /donate/ with the amount chosen
Impact receiptThe receipt-style card beside the donation form. It shows the amount, the cause, and what the amount pays for, from the impact map
Impact mapThe list in the donate file that turns an amount into an outcome, such as “$25: school supplies for one child”
Monthly tierA named monthly gift level, such as Friend or Guardian, shown as a card on /donate/. Written in tiers in the donate file
Cover the feesAn optional line in the donation form that adds a small percentage so card fees don’t come out of the gift (coverFeesPercent)
Tribute giftA gift in honor or in memory of someone. The donation form and /tribute/ offer it
Add to calendarThe .ics file each event page offers, which opens the event in the visitor’s calendar app, and a Google Calendar link
Donate barThe bar at the bottom of phone screens with a short line and the Donate button ([settings.mobileActionBar])
Mega menuThe wide panel under Causes in the header, with one column per category, a featured cause card, and an “All causes” link
PatternsThe faint organic shapes (hearts, leaves, a vine, a wave) behind some sections. patterns = "none" in [settings] turns them off
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: goals, amounts raised, donor counts, the registration number, phone, address, quotes, team members, figures on the impact page, and photos. Replace each one before you launch
Type something to search...