{"id":24571675,"url":"https://github.com/tariqul420/kutto","last_synced_at":"2026-04-13T08:32:53.853Z","repository":{"id":273534046,"uuid":"920022539","full_name":"tariqul420/Kutto","owner":"tariqul420","description":"🐹 Kutto is a MERN-based pet adoption platform connecting users with pets in need of loving homes.","archived":false,"fork":false,"pushed_at":"2025-02-18T06:50:20.000Z","size":2419,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-02-18T07:24:18.363Z","etag":null,"topics":["axios","firebase","keepreact","magicui","motion","react","reactdom","reactselect","stripe","swiper","tanstack-query","tanstack-table"],"latest_commit_sha":null,"homepage":"https://kutto-0.web.app","language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/tariqul420.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2025-01-21T12:34:37.000Z","updated_at":"2025-02-18T06:50:24.000Z","dependencies_parsed_at":"2025-02-18T07:22:46.224Z","dependency_job_id":null,"html_url":"https://github.com/tariqul420/Kutto","commit_stats":null,"previous_names":["tariqul420/kutto"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tariqul420%2FKutto","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tariqul420%2FKutto/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tariqul420%2FKutto/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tariqul420%2FKutto/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/tariqul420","download_url":"https://codeload.github.com/tariqul420/Kutto/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":244005448,"owners_count":20382435,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["axios","firebase","keepreact","magicui","motion","react","reactdom","reactselect","stripe","swiper","tanstack-query","tanstack-table"],"created_at":"2025-01-23T18:21:20.375Z","updated_at":"2026-04-13T08:32:53.810Z","avatar_url":"https://github.com/tariqul420.png","language":"JavaScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003cdiv align=\"center\"\u003e\r\n  \u003ca href=\"https://kutto-0.web.app\" target=\"_blank\"\u003e\r\n    \u003cimg src=\"./src/assets/Logo/kutto-icon.png\" width=\"200px\" alt=\"Kutto\"/\u003e \r\n  \u003c/a\u003e\r\n  \u003ch1\u003eKutto\u003c/h1\u003e\r\n\u003c/div\u003e\r\n\r\n## 📜 Project Overview\r\n\r\nWelcome to **Kutto**, a modern web application designed to facilitate the adoption and donation process for pets. With an intuitive interface, seamless adoption flow, and user-friendly donation system, Kutto aims to revolutionize the way we interact with pet adoption.\r\n\r\n**Kutto** provides a platform for potential pet owners to browse available pets, adopt pets, create donation campaigns for pets, and more. It's a place where pets and their future owners can connect and support each other.\r\n\r\n---\r\n\r\n## 🛡️ Admin email \u0026 password\r\n\r\n- **Email:** admin@gmail.com\r\n- **Password:** Ad1212..\r\n\r\n---\r\n\r\n## 🚀 Live Links\r\n\r\n- **Client Repo:** This repository serves as the main `Kutto` platform and includes the `frontend` setup.\r\n- **Server Repo:** [_github/tariqul420/Kutto-Server_](https://github.com/tariqul420/Kutto-Server.git)\r\n- **Live Site:** [_Kutto.com_](https://kutto-0.web.app)\r\n- **Alternate Live Site:** [_Kutto-2.com_](https://kutto-0.firebaseapp.com)\r\n\r\n---\r\n\r\n## 🔍 React Concepts Used\r\n\r\n- **Components**\r\n- **Hooks**: `useState`, `useEffect`, `useContext`\r\n- **React Router**: `useParams`, `useLocation`, `useNavigate`\r\n- **Conditional Rendering**\r\n- **Context API** for global state management\r\n- **React Hook Form** for form handling and validation\r\n\r\n---\r\n\r\n## 🛠️ Technologies Used\r\n\r\n### 👩🏼‍💻 Frontend\r\n\r\n- **React**\r\n- **Firebase**\r\n- **Tailwind CSS**\r\n- **DaisyUI**\r\n- **React Router**\r\n- **React Icons**\r\n- **React Hot Toast**\r\n- **React Hook Form**\r\n- **JWT-based Authentication**\r\n\r\n### ｡🇯‌🇸‌ Backend\r\n\r\n- **Node.js**\r\n- **Express.js**\r\n\r\n### 🛢️ Database\r\n\r\n- **MongoDB**\r\n\r\n---\r\n\r\n## ✨ Features\r\n\r\n1. **Pet Adoption**: Discover and adopt pets based on your preferences.\r\n2. **User Profiles**: Create personal profiles to manage your adoptions, donations, and pet preferences.\r\n3. **Pet Listings**: View pets available for adoption with detailed profiles.\r\n4. **Booking and Donation System**: Easily book adoption appointments or donate to animals in need.\r\n5. **Rating and Reviews for Pets**: Leave and read reviews to help others make informed adoption decisions.\r\n6. **Search and Filter Pets**: Filter pets by type, age, size, and other characteristics to find the perfect companion.\r\n7. **Interactive Dashboard**: A user-friendly dashboard to track your adoption journey.\r\n8. **Responsive Design**: Fully responsive design that works across all devices.\r\n9. **Pet Matching Algorithm**: Helps users find the best pets suited to their lifestyle.\r\n10. **Pet Medical Records**: Upload and maintain important health information for adopted pets.\r\n11. **Adoption History**: View past adoption records and relevant details.\r\n12. **Pet Care Guides**: Access educational resources on pet care and training.\r\n13. **Pet Donation System**: Support animal shelters or individual pets through donations.\r\n14. **Live Chat with Pet Owners**: Chat in real-time with pet owners or shelter representatives.\r\n15. **Geo-location Based Pet Listings**: Discover pets available for adoption near you.\r\n16. **Video Calls for Pet Meetups**: Meet your potential pet virtually before committing to adoption.\r\n17. **Pet Insurance Integration**: Purchase insurance for your adopted pet through the platform.\r\n18. **Pet Adoption Events**: Discover adoption events and fairs in your area.\r\n19. **Pet Foster Program**: Foster pets temporarily while waiting for a permanent home.\r\n20. **Review and Feedback System**: Share your adoption experience with others.\r\n21. **Pet Wishlist**: Save pets to your wishlist and get notified when they become available.\r\n22. **Pet Profile Customization**: Customize pet profiles to increase their adoption chances.\r\n23. **Pet Transportation Assistance**: Get help with delivering your adopted pet to your home.\r\n\r\n---\r\n\r\n## 🧰 NPM Packages Used\r\n\r\n- @stripe/react-stripe-js\r\n- @stripe/stripe-js\r\n- @tanstack/react-query\r\n- @tanstack/react-table\r\n- axios\r\n- class-variance-authority\r\n- clsx\r\n- dompurify\r\n- embla-carousel-autoplay\r\n- firebase\r\n- keep-react\r\n- lottie-react\r\n- lucide-react\r\n- motion\r\n- phosphor-react\r\n- prop-types\r\n- react\r\n- react-datepicker\r\n- react-dom\r\n- react-hook-form\r\n- react-hot-toast\r\n- react-icons\r\n- react-intersection-observer\r\n- react-loading-skeleton\r\n- react-quill\r\n- react-router-dom\r\n- react-select\r\n- react-spinners\r\n- sweetalert2\r\n- swiper\r\n- tailwind-merge\r\n- tailwindcss-animate\r\n\r\n---\r\n\r\n## 🛠 Installation\r\n\r\n### Prerequisites\r\n\r\n- **Node.js** and **npm** installed\r\n- **MongoDB** connection string\r\n\r\n---\r\n\r\n### Client Side Setup\r\n\r\n1. Clone the client-side repository:\r\n\r\n   ```bash\r\n   git clone https://github.com/tariqul420/Kutto.git\r\n   cd Kutto\r\n   ```\r\n\r\n2. Install dependencies:\r\n\r\n   ```bash\r\n   npm install\r\n   ```\r\n\r\n3. Start the development server:\r\n   ```bash\r\n   npm run dev\r\n   ```\r\n4. Open the project in a code editor:\r\n   ```bash\r\n   code .\r\n   ```\r\n5. Add the `.env` file in the root directory and include the following environment variables:\r\n   ```bash\r\n   VITE_API_KEY=_____________________________\r\n   VITE_AUTH_DOMAIN=_________________________\r\n   VITE_PROJECT_ID=__________________________\r\n   VITE_STORAGE_BUCKET=______________________\r\n   VITE_MESSAGE_SENDER_ID=___________________\r\n   VITE_APP_ID=______________________________\r\n   VITE_MEASUREMENT_ID=______________________\r\n   VITE_IMGBB_API_KEY=_______________________\r\n   VITE_SERVER_API_URL=______________________\r\n   VITE_STRIPE_CLIENT_SECRET=________________\r\n   ```\r\n   \u003e **Note:** Replace the `VITE_API_KEY` and `VITE_AUTH_DOMAIN`, along with other placeholders, with actual values.\r\n\r\n### Server Side Setup\r\n\r\n1. Clone the client-side repository:\r\n\r\n   ```bash\r\n   git clone https://github.com/tariqul420/Kutto-Server.git\r\n   cd Kutto-Server\r\n   ```\r\n\r\n2. Install dependencies:\r\n\r\n   ```bash\r\n   npm install\r\n   ```\r\n\r\n3. Start the server:\r\n\r\n   ```bash\r\n   node index.js\r\n   ```\r\n\r\n   --- OR ---\r\n\r\n   ```bash\r\n   nodemon index.js\r\n   ```\r\n\r\n4. Open the project in a code editor:\r\n   ```bash\r\n   code .\r\n   ```\r\n5. Add the `.env` file in the root directory and include the following environment variables:\r\n   ```bash\r\n   DATABASE_USERNAME=________________________\r\n   DATABASE_PASSWORD=________________________\r\n   ACCESS_TOKEN_SECRET=______________________\r\n   STRIPE_SECRET_KEY=________________________\r\n   ```\r\n   \u003e **Note:** Replace the `index.js` file's `mongo_uri` and the `.env` file's `DATABASE_USERNAME`, `DATABASE_PASSWORD`, `ACCESS_TOKEN_SECRET` and `STRIPE_SECRET_KEY` with actual values.\r\n\r\n## 🧑‍💻 Authors\r\n\r\n- Tariqul Islam (Lead Developer)\r\n- Lead Developer \u0026 Maintainer\r\n- Connect with me on [_GitHub_](https://github.com/tariqul420) \u0026 [_Facebook_](https://www.facebook.com/tariqul.islam.fb)\r\n\r\n## 📸 Screenshots\r\n\r\n### 1. Home Page\r\n\r\n![Home Page](https://github.com/tariqul420/Kutto/blob/main/src/assets/Screenshots/home.png)\r\n\r\n### 2. Dashboard\r\n\r\n![Dashboard](https://github.com/tariqul420/Kutto/blob/main/src/assets/Screenshots/dashboard.png)\r\n\r\n### 3. Pet Listing Page\r\n\r\n![Pet Listing Page](https://github.com/tariqul420/Kutto/blob/main/src/assets/Screenshots/pet-listing.png)\r\n\r\n### 4. Donation Campaign Page\r\n\r\n![Donation Campaign Page](https://github.com/tariqul420/Kutto/blob/main/src/assets/Screenshots/all-donation.png)\r\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftariqul420%2Fkutto","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Ftariqul420%2Fkutto","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftariqul420%2Fkutto/lists"}