Skip to content

Edgartheprogrammer/Cats-adoption

Repository files navigation

🐾 Adopt Meow! - Find Your Purr-fect Companion 🐱

📜 About This Project

Tired of scrolling through endless cat videos and wishing you could cuddle one in real life? Adopt Meow connects adorable kitties with loving humans like you! Browse, fall in love, and bring home your new best friend.

Screenshot 2025-03-28 160607

🚀 Features

  • Browse Cats - See all the fluffy, mischievous, and sleepy cats up for adoption
  • ❤️ Save Favorites - Heart your top picks so you don't lose them!
  • 🏠 Adopt Now - Simple form to start the adoption process
  • 🌑 Dark Mode - Browse without hurting your eyes. Switch to dark mode!
  • 🧪 Tests - Jest tests covering essential units
    • Unit Tests: Jest + React Testing Library
    • E2E Tests: Cypress
# Run Cypress tests
npm run cy:open  # Interactive mode
npm run cy:run   # Headless mode

👥 Meet the Team

Role Member GitHub LinkedIn
Product Owner Natalia (😴 Chief Nap Officer) @NataKaz Natalia
Scrum Master Omar (⌨️ Head of Keyboard Walking) @Edgartheprogrammer Omar
Developer Hema (🧶 Ball of Yarn Manager) @void-craft Hema

🛠️ Quick Start

Installation

git clone https://github.com/yourusername/adopt-cat.git
cd adopt-cat
npm create vite@latest
# Select: React -> JavaScript
npm install

Development

npm run dev

Open your browser and go to http://localhost:5173

Testing

# Install test dependencies
npm install --save-dev jest @testing-library/react @testing-library/jest-dom @testing-library/user-event jest-environment-jsdom @swc/jest identity-obj-proxy cross-env

# Run tests
npm test

# Clear cache (if needed)
npx jest --clearCache
rm -rf node_modules/.cache

Project Structure

Cats-adoption/
│ ├── public/
│ ├── __mocks__/
│ ├── cypress/
│ ├── src/
│ │ ├── components/
│ │ ├── pages/
│ │ ├── services/
│ │ ├── stores/
│ │ ├── styles/
│ │ ├── tests/
| | |   └── pages/
│ │ ├──  App.jsx
| | ├── main.jsx/
├── .gitignore
├── .swcrc
├── jest.setup.js
| | |   └── package.json
| | |   └── package-lock.json
└── README.md
└── vite.config.js

📬 How to Contribute

Found a bug? Have an idea to make this more pawsome? 🐛 Open an issue 💻 Submit a pull request 📢 Spread the word!.

🐈 Adopt, don’t shop! 🐈

Made with ❤️ (and a lot of cat hair).

About

No description, website, or topics provided.

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Contributors 3

  •  
  •  
  •