Getting Started:

Step 1: Download And Install DigiGoat

Let’s get DigiGoat on your computer and ready to use.

Download DigiGoat

  1. Go to https://github.com/DigiGoat/client-app/releases/latest.
  2. Download the installer for your computer:
    • Windows: download the file ending in .Setup.exe.
    • Mac: download -arm64.dmg for M-series Macs, or -x64.dmg for Intel Macs. If you’re unsure, pick -x64.dmg.

Install DigiGoat

  1. Windows: After download, Windows may show a warning. Click the More info link, then choose Run anyway. Then open the installer from your Downloads folder. (Video coming soon.)
  2. Mac: Open the downloaded .dmg, then drag DigiGoat into your Applications folder. (Video coming soon.)
    Important (macOS security): Due to recent Apple restrictions, you may need to “de-quarantine” the app. Open the Terminal app and run:
    xattr -d com.apple.quarantine /Applications/DigiGoat.app

Prepare The App (Git)

The first time you open DigiGoat, you may see an error like “Git Not Installed!”. Git is the tool DigiGoat uses behind the scenes to track and upload your changes.

Follow the instructions shown in the app to install Git. Once Git is installed, restart DigiGoat and you’re good to go.

Step 2: (Optional) Try It Out First (For Free!!!!)

When DigiGoat opens it will present you with setup options. If you’d like, enter in your name and email. Don't worry, these are only used for if you publish, until then nothing leaves the app. This will setup a blank website. From here you can build your whole site without paying anything.

When you decide you want to publish publicly, we can keep the work you’ve already done.

Until then, you can preview what your site would look like using Live Preview.

Step 3: Purchase DigiGoat

  1. When you're ready to go public, head over to https://buy.digigoat.app/ to checkout.
  2. If you want to set up custom email and/or email forwards, you can add those to your subscription. (For email forwards, set the quantity to however many forwards you want.)
  3. Watch your inbox for any follow-up questions. When your setup is ready, you’ll receive an email from onboarding@digigoat.app with setup instructions.

(Optional) Step 4: Set Up A Custom Email

If you want an email address at your farm domain (example: Digi@yourfarm.com), choose one of the options below.

Option A: Email Forwards (Easiest)

  1. Email onboarding@digigoat.app with:
    • the addresses you want forwarded (they must end with your farm domain, e.g. if your farm is yourfarm.com a possible email is Digi@yourfarm.com)
    • the destination email address(es) you want them forwarded to
  2. Email forwards are quick to set up. The main caveat: when you reply, it will usually send from your personal email address (not the forwarded address).
  3. You’re limited to up to 20 free forwarded addresses with this option, which is plenty for most farms. ($5/year per forward after that)

Option B: iCloud Custom Email Domain

  1. You’ll need an iCloud+ plan (any tier works; they start around $12/year).
  2. Go to https://www.icloud.com/icloudplus/Custom Email DomainAdd a domain you own.
  3. Select whether you’re creating emails for family or just yourself, then enter your website domain (example: yourfarm.com).
  4. (Image coming soon.) When you receive Apple’s email with the subject/header “Finish setting up your custom email domain”, forward it to onboarding@digigoat.app.
  5. After DigiGoat finishes the DNS setup, you’ll get a reply instructing you to return to the iCloud page and click Verify for your domain.
  6. You can then create up to 3 email addresses that can send/receive mail. Note: If you want to receive email for more than those 3 addresses, enable Allow All Incoming Messages. (Image coming soon.)

Step 5: Next Steps

Now that DigiGoat is installed and your project is set up, here’s a good path to get your site looking great quickly.

Live Preview

Live Preview lets you see what your site will look like as you make changes, even before publishing.

  1. In DigiGoat, click the Live Preview button in the top-right.
  2. The first time you do this, it will request permission to download Node.js (this is a javascript compiler required to compile your website)
  3. You will also be prompted that dependencies need to be installed. This will happen periodically in the future as well from certain DigiGoat updates, but they will be much faster after the first time
  4. Once everything is downloaded, it will take a moment or two to compile your website and then a window will pop up with exactly as your website will look on the internet
  5. If you edit your goats or homepage you will notice changes reflected immediately once you hit save

Note: Live Preview uses your computer’s resources to run. If you notice performance issues, try closing the Live Preview window when you’re not actively using it. Additionally, you may have any of these steps running in the background as you work on your website, they will not cause interference

Create Your Website’s Homepage

  1. If you see a prompt that says Login To Your ADGA Account, click it. Once signed in, several fields can be auto-filled.
  2. Fill out your farm’s name (full name, plus an abbreviated name if desired).
  3. Fill out the owner field (shown on your homepage and in the footer of every page).
  4. Enter a contact email (shown on your homepage and in the footer). This is also the email DigiGoat will use to contact you when new milk test data is synced.
  5. Add content for your homepage (Markdown and images supported).
  6. Add sale terms and pricing info (recommended if you plan to enable the kidding schedule or for-sale pages).
  7. Add your farm’s socials (Facebook, Instagram, and Threads currently supported).

Create Your Site’s Favicon

Your favicon is the small icon shown in the browser tab, navbar, and on your homepage.

  1. Go to https://realfavicongenerator.net and upload your farm’s logo.
  2. Go through the steps and adjust settings to frame your logo best. (Ignore fields asking for your website name/theme colors; DigiGoat fills these out automatically.)
  3. Click Next, then click Download.
  4. Unzip the downloaded file.
  5. In DigiGoat, click Change Favicon and select the folder you just unzipped.
  6. That’s it!

Add Your Goats

  1. Click Sync All (yep, it’s that easy).
  2. When sync finishes, you should see the goats currently in your ADGA account.
  3. To delete a goat, hover over their name and click the red trash can.
  4. To manually add a goat, type their name or ID in the relevant list’s search bar. When results load, click your animal. (You can add pets too—just click Add unregistered goat in the results.)
  5. Recommended: Click each animal and set their nickname (what you call them in the barn). DigiGoat will suggest the last word of the registered name.
  6. To fix capitalization in a name, click the letter you want to change.
  7. You can add a description for each animal. The first 3 lines show in list views; the full description shows on the goat’s page. (Markdown supported.)
  8. To add images: return to the main window, hover over a goat, click Add images, then click or drag/drop uploads. If you’re migrating from an old site, you can right-click an existing image, copy its link, paste it under the upload button, and DigiGoat can download it for you.
  9. To re-order goats: hover the goat you want to move, grab the 3-bar handle, and drag it to the desired position.

Add References

References are for animals that you’ve owned or sold but still want to display.

  1. In the References search bar, type an animal’s name or ID.
  2. Follow the same process as Add your goats.
  3. Recommended: Run Sync All again when you’re done. At minimum, run Sync Related.
  4. When you’re ready to show the page on your site, flip the switch to Enabled.

Add Goats For Sale

  1. Use the search bar to look up animals the same way you do for References.
  2. Follow the same process as Add your goats.
  3. You’ll also be able to set a price, which is displayed on the animal and in the list for quick reference.
  4. Recommended: Run Sync All again when you’re done. At minimum, run Sync Related.
  5. When you’re ready to show the page on your site, flip the switch to Enabled.

Add A Kidding Schedule

  1. Go to the Kidding Schedule tab in the app.
  2. (Optional) Add a description at the top of the list to display on your kidding schedule page.
  3. Click Add a breeding to add an entry.
  4. In the breeding, click the Dam input and start typing the doe’s name or ID. Matching goats will appear from your Does and References lists. Click the doe you want.
  5. For the Sire, do the same process—search results come from your Bucks and References lists.
  6. After breeding, enter the date in the Exposed field.
  7. The due date auto-calculates from Exposed (145 days for Nigerian Dwarfs, 150 for Standards). Note: it won’t switch to 145 until a Nigerian Dwarf is selected as the Dam, so wait to rely on the due date until after you’ve selected the Dam.
  8. (Optional) Add notes (ultrasound counts are a great use here).
  9. When the doe kids, enter the date in Kidded. (At that point, the website no longer displays the original due date—it’s kept for your records.)
  10. When you’re ready to show the page, flip the switch to Enabled.
  11. To rearrange breedings, use the same 3-line grab handle as reordering goats. (An update is in the works to make this easier.)

Add Custom Pages

Custom pages are perfect for those types of pages that just can't be automated, like "About Us", "Goat Milk Soap", or "Goat Cheese".

  1. To add a custom page, go the the custom pages tab in the app.
  2. Click Add a Custom Page.
  3. This should open the page you just created. In it, give the page a title (to be displayed in your sites menubar) and some content (markdown supported).
  4. Once you're done, close the window and you're good to go!

Step 6: Updating the App

DigiGoat will occasionally release updates to add new features, fix bugs, and improve performance. When an update is available, you’ll see a notification in the app.

Download DigiGoat

  1. Just like when you first installed DigiGoat, you need to go to https://github.com/DigiGoat/client-app/releases/latest.
  2. Download the installer for your computer:
    • Windows: download the file ending in .Setup.exe.
    • Mac: download -arm64.dmg for M-series Macs, or -x64.dmg for Intel Macs. If you’re unsure, pick -x64.dmg.

Install DigiGoat

  1. Windows: After download, Windows may show a warning. Click the More info link, then choose Run anyway. Then open the installer from your Downloads folder. (Video coming soon.)
  2. Mac: Open the downloaded .dmg, then drag DigiGoat into your Applications folder. (Video coming soon.)
    Important (macOS security): Due to recent Apple restrictions, you may need to “de-quarantine” the app. Open the Terminal app and run:
    xattr -d com.apple.quarantine /Applications/DigiGoat.app

That's It!

Git is still installed on your computer from when you first set up DigiGoat, so you're now good to go!