Glossary
Plain-language meanings of the words used in these docs.
Theme Words
| Word | What it means |
|---|---|
| Astro | The tool that turns Givo’s files into a website. You don’t need to learn it to edit content |
| Tailwind CSS | The styling system. Classes like bg-primary or mt-8 in components set colors and spacing |
| Static site | A website made of ready-made files, with no database or server code to run, so it is simple to host |
| Node.js | The program that runs Astro on your computer |
| npm | Comes with Node.js. Installs the theme’s tools (npm ci or npm install) and runs its commands (npm run dev) |
| Terminal | A window where you type commands. In VS Code: Terminal → New Terminal |
| Dev server | The local copy of your site at http://localhost:4321/ that updates when you save. Started with npm run dev |
| Build | Turning the files into the finished website in the dist/ folder, with npm run build |
| Deploy | Putting the built site on the internet, on a host such as Netlify, Vercel, or Cloudflare Pages |
| Route | A file in src/pages/ that becomes a page and decides which sections it shows |
| Section | One full-width block of a page (hero, causes, FAQ). A component plus a content file |
| Component | A .astro file that draws part of the page. You rarely need to edit these |
| Content file | A .md or .mdx file in src/content/ that holds text and options |
| Markdown | A simple way to format text: **bold**, ## heading, - list item |
| MDX | Markdown that can also use components (shortcodes) such as <Notice> or <Accordion> |
| Shortcode | A ready-made component you can place inside an .mdx file. /components/ on your local site shows them all |
| Frontmatter | The settings block between two --- lines at the top of a content file, written in YAML |
| YAML | The key: value format used in frontmatter. Indentation matters |
| TOML | The key = value format of config.toml, grouped under [tables] |
| JSON | The "key": "value" format of the menu, language, font, social, and translation files |
| Collection | A folder of similar entries: causes, events, stories, team members, supporter quotes, job openings |
| Entry | One file in a collection, which usually becomes one page |
| Slug | The part of the URL that names a page: clean-water-wells in /causes/clean-water-wells/. Comes from the file name, or customSlug |
| Named block | A section’s settings written inside a page’s frontmatter, to change that section on that page only |
| Layout | One of the looks a section can have, chosen with options.layout. /elements/ previews them |
| Draft | A page with draft: true. It shows on the dev server but is not built |
| i18n | Short for “internationalization”: the multi-language setup |
| RTL | Right to left: the reading direction of languages such as Arabic. Givo’s Arabic pages are mirrored |
| Schema | The 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 |
| Lucide | The free icon set Givo uses. Any name from lucide.dev/icons works, for example "HandHeart" or "Droplets" |
| Dark mode | The dark color scheme. Visitors switch with the light/dark button; [settings.colorScheme] default sets what they see first |
| Open Graph image | The preview picture shown when a link is shared on social media or in chat apps. Givo generates one per page |
| Structured data | Hidden JSON-LD in each page that tells search engines about your organization, events, stories, and FAQ |
| Sitemap | A list of every page, for search engines (/sitemap-index.xml) |
llms.txt | A proposed format: a Markdown map of your site, with your organization facts first, that AI assistants can read |
| Git | A tool that saves versions of your project, so you can undo any change |
| Commit | One saved version in git |
| Diff | A view of exactly what changed in a file: removed lines and added lines |
Givo Words
| Word | What 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 number | Your charity or non-profit number (registrationNumber in [organization]). It shows in the footer and the donation form’s fine print. Empty hides it |
| Cause | One 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 |
| Category | A 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, donors | The 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 |
| Deadline | The 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 bar | The bar that shows how much of the goal is raised. It never goes past 100% |
| Donation form | The 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 donate | The short donation panel on the main homepage: frequency, preset amounts, and a button that opens /donate/ with the amount chosen |
| Impact receipt | The receipt-style card beside the donation form. It shows the amount, the cause, and what the amount pays for, from the impact map |
| Impact map | The list in the donate file that turns an amount into an outcome, such as “$25: school supplies for one child” |
| Monthly tier | A named monthly gift level, such as Friend or Guardian, shown as a card on /donate/. Written in tiers in the donate file |
| Cover the fees | An optional line in the donation form that adds a small percentage so card fees don’t come out of the gift (coverFeesPercent) |
| Tribute gift | A gift in honor or in memory of someone. The donation form and /tribute/ offer it |
| Add to calendar | The .ics file each event page offers, which opens the event in the visitor’s calendar app, and a Google Calendar link |
| Donate bar | The bar at the bottom of phone screens with a short line and the Donate button ([settings.mobileActionBar]) |
| Mega menu | The wide panel under Causes in the header, with one column per category, a featured cause card, and an “All causes” link |
| Patterns | The faint organic shapes (hearts, leaves, a vine, a wave) behind some sections. patterns = "none" in [settings] turns them off |
| Layout switcher | A floating Change layout button for the theme’s demo. Off by default ([settings.layoutSwitcher] enable = false); keep it off on your site |
| Sample | A 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 |