Make Givo 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 = "Riverside Food Bank"baseUrl = "https://www.your-domain.org"logoText = "Riverside Food Bank"titleis your organization’s 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.logoTextis the wordmark in the header. Its first “i” gets the heart as its dot; a name without an “i” gets the heart before the text.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.- Every page title ends with a tagline (
<page> - <tagline>). Each language has its own, inseo.taglineinsrc/i18n/<language>.json, next toseo.siteDescription(the description of pages without their own). Rewrite both in every language. Ataglineordescriptionset in[site]is used for every language instead.
Details: Site Identity & Logo and Config Reference.
-
Add your organization details
Your organization’s details live in one place,
[organization]in the same file. The header, footer, contact page, donation form fine print, event pages, structured data, andllms.txtall use them:[organization]name = "" # empty uses site.titlelegalName = "" # registered legal name, if differentregistrationNumber = "12-3456789" # your charity or non-profit number; empty hides it[organization.address]show = true # false = no public street addressstreet = "100 Example Street, Suite 200"locality = "Springfield"region = "ST"postalCode = "00000"country = "US"Every value marked
# samplein the file is a placeholder: the shipped registration number, email ([email protected]), and address are not real. Details: Organization Info. -
Set your phone number and office hours
Still in
[organization]:[organization]phone = "+15550100199" # digits with country code, for tap-to-call linksphoneDisplay = "(555) 010-0199" # how the number is showntimezone = "America/New_York" # office hours and event timesclosedDates = ["2026-12-25", "2027-01-01"][organization.hours]mon = "09:00-17:00"fri = "09:00-16:00"sat = "" # empty = closedThe shipped number is in the fictional
555-01xxrange: 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 an[organization]warning in the terminal and is ignored, so watch the terminal after you save. -
Set your currency and donation amounts
Donation numbers are not typed into pages. They come from one file,
src/content/donate/english/-index.md, which feeds the donation form, the quick donate panel on the homepage, the monthly giving tiers, and the impact lines under each amount:currency: "USD" # ISO 4217 code, one currency for every languageamounts:oneTime: [25, 50, 100, 250, 500] # preset buttons, one-timemonthly: [10, 20, 35, 50, 100] # preset buttons, monthlydefault:oneTime: 50monthly: 20minimum: 5 # smallest custom amountcoverFeesPercent: 3 # 0 hides the "cover the fees" lineimpactMap:- amount: 25label: "school supplies for one child"The amounts and the outcomes in
impactMapandtiersare samples: replace them with your own costs. Copy the same numbers into the file of every other language, such assrc/content/donate/french/-index.md:npm run buildprints a[donate]warning when they differ. Details: Donation Form and Giving Tiers & Receipt. -
Connect the donation form to your payment provider
Until you do, the form sends nothing, and the dev server shows a notice inside it. In the same file, pick one of two ways:
form:mode: "form" # form | redirectendpoint: "" # "form": the URL your payment provider or form service gives youmethod: "post"processorUrl: "" # "redirect": a hosted checkout, e.g. "https://checkout.example.org/donate?amount={amount}&interval={frequency}"thanksUrl: "/donate/thanks/"mode: "form"sends every field toendpoint.mode: "redirect"sends the donor toprocessorUrl, a hosted checkout page from your provider or donation platform.{amount},{frequency}, and{cause}in it are filled in.
Set the same
formvalues in every language. Details: Donation Form. -
Replace the sample causes
The 9 causes in
src/content/causes/english/are samples. Each file is one cause, and its file name is its URL (clean-water-wells.mdis/causes/clean-water-wells/):title: "Clean water wells"category: "water" # id from `categories:` in -index.mdgoal: 75000 # sampleraised: 48900 # sampledonors: 640 # sampledeadline: 2027-04-30 # sample; remove for an ongoing causefeatured: trueRename or copy a file for each real cause and set your own goal, amount raised, and donors. These are numbers you update by hand: the site does not count gifts. The progress bar and the days left come from them, and the days left are counted when the site is built, so rebuild the site every day while an appeal runs. Add each cause to the Causes mega menu in each
src/config/menu.<language>.json. Details: Causes & Campaigns. -
Set your brand colors and logo
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: #087f44; /* green: buttons, links, progress bars */--theme-accent: #087f44;--theme-gold: #e6b35a; /* the donation panel and small marks */--theme-band: #0f2a1f; /* forest: the footer and solid bands */}Change the matching lines in
:root.darktoo, then check both modes with the light/dark button in the header.Givo draws a built-in wordmark with a heart from
logoText. To use your own logo file instead, put it inpublic/orsrc/assets/and setlogoin[site](withlogoWidthandlogoHeight). Then set[site.favicon] imageto a square version of your logo and runnpm run generate-favicons. Details: Colors & Fonts and Site Identity & Logo. -
Connect the contact, volunteer, and newsletter forms
The contact, volunteer, and fundraise forms 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 | netlifyThe newsletter sign-up needs your Mailchimp address in
formActionunder[settings.subscription]. Details: Forms. -
Replace the photos
The sample photos are in
src/assets/images/photos/, named by use (cause-,event-,story-,team-,gallery-, and so on). Content files point at them with paths that start with/images/:image: "/images/photos/cause-water-tap.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 or the donation form is not connected (steps 5 and 8), and[donate]means the donation files of your languages differ (step 4). Then follow the Deployment guide, which has the full launch checklist.
What Next?
- Pick your homepage: Givo has three (
/,/home-appeal/,/home-community/). 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 sample events: Events & Calendar.
- Replace the sample figures on
/impact/and the “where your money goes” split: Impact & Transparency. - Replace the demo content page by page: Pages lists every page and its file.
- Try the other layouts of your sections: Section Layouts.
- Let an AI assistant do the repetitive work: Prompt Library.