Skip to content

TiagoRibeiro25/PawShare

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

paw-share-logo

Paw Share

"Empowering Care for Animals and Their Guardians in Challenging Times"

School Project

Table of Contents

About 💡

Paw Share is a compassionate application committed to aiding animals and their caregivers during difficult times. Our app connects individuals facing the challenge of caring for their pets or encountering animals in distress with appropriate solutions to ensure the well-being of these cherished creatures.

We stand firmly against the promotion of animal breeding for profit and instead advocate for responsible adoption and support for animals in distress. At Paw Share, our mission is to foster a culture of empathy and assistance towards animals in need.

Moreover, Paw Share facilitates temporary pet care, enabling pet owners to entrust their beloved companions to the care of others during their absences or times of incapacity. Our primary focus is not financial gain, but rather, it is on cultivating and strengthening the bonds shared by passionate animal lovers like you.

Tech Stack 💻

Actors & User Stories 📝

ACTORS_USERS_STORIES.md

Getting Started 🚀

Prerequisites

If you don't have or want to use Docker, you will need to have:

  • A mysql database running locally or remotely on port 3306 (be sure to update the credientials in the .env file)

Installation

Automated (experimental)

  1. Clone the repo

  2. Run the setup script (use the correct script for your OS)

Linux or MacOS
chmod +x ./scripts/setup-project.sh && ./scripts/setup-project.sh
Windows
./scripts/setup-project.bat
  1. Create a .env file in the following directories:
  • /packages/api
  • /packages/app
  • /packages/web

And follow the .env.example file in each directory to fill in the required environment variables.

  1. Run the project (use the correct script for your OS)
Linux
chmod +x ./scripts/start-project.sh && ./scripts/start-project.sh

If you get an error saying that a command was not found, edit the start-project.sh file and add your current terminal to the list of terminals (line 3).

Example
local terminals=("x-terminal-emulator" "gnome-terminal" "konsole" "YourTerminal")

To find out the name of your terminal, run the following command:

ps -p $(ps -p $$ -o ppid=) -o comm=
MacOS
chmod +x ./scripts/macos-start-project.sh && ./scripts/macos-start-project.sh
Windows
./scripts/start-project.bat

Manual

  1. Clone the repo

  2. Install NPM packages

  cd packages/api
  npm install
 
  cd ../app
  npm install

  cd ../web
  npm install
  1. Create a .env file in the following directories:
  • /packages/api
  • /packages/app
  • /packages/web

And follow the .env.example file in each directory to fill in the required environment variables.

  1. Start the database
cd packages/api
npm run db
  1. Start the API
cd packages/api
npm run dev
  1. Start the app
cd packages/app
npm start
  1. Start the web client
cd packages/web
npm run dev

Contributors 📝


Back to top

About

Mobile App made with React Native

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Contributors 4

  •  
  •  
  •  
  •