The Pet Rescue app is derived from the Baja Pet Rescue Dog Adoption Application created by @kasugaijin who wanted to give back to the grassroots organization from where he adopted his dog in Mexico by building them a web application. Pet Rescue is an application that makes it easy to link adopters with pets.

Let's get your machine setup to startup the application!

⚠️ We assume you already have ruby installed with your preferred version manager. This codebase supports rbenv and asdf.

Clone the codebase

git clone [email protected]:rubyforgood/pet-rescue.git

Create a new config/application.yml file from the config/application.example.yml:

cp config/application.example.yml config/application.yml

Update your config/application.yml by replacing the places that say REPLACE_ME.

Run the setup script to prepare DB and assets

bin/setup

To run the app locally, use:

bin/dev

You can use the following login credentials to access the following roles:

Adopter

• email: [email protected]
• password: 123456

Staff

• email: [email protected]
• password: 123456

You are also able to register an account.

The app will work OK with no subdomains, but to really test out the multi-tenant capabilities, you will need to configure subdomains. Every Organization has a subdomain field, and that Org will be accessible via ApplicationController#current_tenant.

To configure your local dev env to test subdomains, you will need to edit your /etc/hosts file

Add the following line:

127.0.0.1  pet-rescue.local alta.pet-rescue.local rubyforgood.pet-rescue.local

This will map the two seed Orgs with the correct subdomains

Run unit tests only

./bin/rails test

Run system tests only (Headless)

./bin/rails test:system

Run system tests only (Not-Headless)

CI=false ./bin/rails test:system

Note: If system tests are failing for you, try prepending the command with APP_HOST=localhost. Your host might be misconfigured.

APP_HOST=localhost ./bin/rails test:system

Run ALL tests:

./bin/rails test:all

We use standard for linting. It provides a command for auto-fixing errors:

rails standard:fix

This google sheets contains a list of tools, their purposes, and who has access to grant permissions.

Pet Rescue is one of many projects initiated and run by Ruby for Good. You can find out more about Ruby for Good at https://rubyforgood.org

Baja Pet Rescue

These are just some of the documents put together before writing any code:

• Slide deck to pitch idea to client: here
• Figma site design: here
• Model association diagram: here