Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/nina1012/fip-catcare
App for tracking and managing medication schedules, daily health logs and test results for cats undergoing treatment for FIP π π
https://github.com/nina1012/fip-catcare
cats medical-application pet-health playwright react react-query react-testing-library typescript vite vitest
Last synced: 20 days ago
JSON representation
App for tracking and managing medication schedules, daily health logs and test results for cats undergoing treatment for FIP π π
- Host: GitHub
- URL: https://github.com/nina1012/fip-catcare
- Owner: nina1012
- License: mit
- Created: 2024-08-02T12:29:37.000Z (5 months ago)
- Default Branch: main
- Last Pushed: 2024-11-22T19:34:48.000Z (about 2 months ago)
- Last Synced: 2024-11-22T20:29:08.526Z (about 2 months ago)
- Topics: cats, medical-application, pet-health, playwright, react, react-query, react-testing-library, typescript, vite, vitest
- Language: TypeScript
- Homepage: https://fip-cat-care.vercel.app
- Size: 4.05 MB
- Stars: 4
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# FIP CatCare App π ππ
_(π features, ongoing updates!)_
The only app you need to monitor, manage and analyze your cat's FIP treatment progress, helping you stay informed and proactive every step of the way
![Application overview image](./public/screenshots/FIP-CatCare.png)
## Table of Contents
- [Project Description](#project-description-)
- [Getting started](#getting-started-)
- [Installation and Setup](#installation-and-setup)
- [Contribution](#contributing)
- [Problem and how FIP CatCare app solves it](/docs/Problem.md)
- [App requirements, users stories and tables and database relationship](/docs/App-requirements.md)## Project Description π
**FIP CatCare app** is a web app for tracking and managing medication schedules, daily health logs and test results for cats undergoing treatment for FIP. For owners of FIP positive cats, in hope for fast recovery π
This app helps users manage their cats' schedules, add notes and set reminders and upload test results (bloodwork, etc.).### Brief Introduction and Explanation of FIP π¦
#### What is FIP?
Feline Infectious Peritonitis (FIP) is a serious viral disease that affects cats, caused by certain strains of the feline coronavirus. While many cats infected with feline coronavirus remain healthy, a small percentage of cats develop FIP, which can be fatal if left untreated.
#### How Can FIP Be Treated?
FIP used to be considered untreatable, but recent advances have made treatment possible using specific antiviral medications. The treatment often involves precise dosing based on the catβs weight, the type of FIP (wet, dry, ocular, or neurological) and the medicationβs concentration.
## Getting Started π»
#### Important Notice β οΈ
**Please Note**: Some actions and features in this project are **not functional in production** because they rely on specific data or configurations that have yet to be pushed to the production database.
You have two options to get started with the **FIP CatCare App**:
1. **Use the Test Account**:
- If you want to quickly explore the app's functionality, you can use the test account provided below:
- **Email**: [email protected]
- **Password**: password**Note**: This test account is read-only and designed for preview purposes. Any data entered or modified will not be saved permanently.
2. **Follow Installation Instructions**:
- If youβd like to set up the app on your local machine, please follow the installation instructions below:## Installation and Setup π οΈ
1. **Clone the repository:**
```bash
git clone [email protected]:nina1012/FIP-CatCare.git
cd FIP-CatCare
```2. **Install dependencies:**
```bash
npm install
```3. **Set up environment variables:**
1. **Create a `.env` file** in the root directory of your project:
```bash
touch .env
```2. **Add the following variables to your `.env` file.** Replace `` and `` with your actual Supabase credentials:
```bash
VITE_SUPABASE_URL=
VITE_SUPABASE_ANON_KEY=
```3. **Example of how your `.env` file should look:**
```bash
VITE_SUPABASE_URL=https://your-project-id.supabase.co
VITE_SUPABASE_ANON_KEY=your_anon_key
```**Note**: Ensure that your `.env` file is not shared publicly, as it contains sensitive information. Since this app is built using Vite, remember to prefix your environment variables with `VITE_`
4. **Run the development server:**
```bash
npm run dev
```## Contributing π‘
Contributions are always welcome to make this project better together! β¨ If you have any ideas, suggestions, or fixes, feel free to contribute. Follow the steps to get started:
1. **Fork the Repository**
Click the "Fork" button at the top-right corner of this repository to create your copy.
2. **Clone Your Fork**
Clone the forked repository to your local machine:
```bash
git clone https://github.com/your-username/FIP-CatCare.git
```
3. Create a branch: `git checkout -b feature-name`
4. Install dependecies by running the `npm install` script.
5. Make some changes
6. Test your changes
7. Commit your changes
```bash
git commit -m "Add: Description of your changes"
```
8. Push your branch and open a Pull RequestThank you for contributing and helping improve this project! β€οΈ
### Design Inspiration π¨
This projectβs design was inspired by [FIP Oasis](https://fipoasis.com) and [Cure FIP](https://www.curefip.com/), with custom tweaks to fit my appβs functionality and style.
![FIP CatCare App](./public/FIPCatCare-logo.png) (FIP CatCare App)