Skip to content

Tailmate is a cross-platform Flutter application that helps users discover and adopt pets. It offers a clean, responsive UI for both mobile and web platforms, with features like pet listing, pet details, favorites, and image handling.

Notifications You must be signed in to change notification settings

TheScriptRailoth/tailmate

Folders and files

NameName
Last commit message
Last commit date

Latest commit

Β 

History

21 Commits
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 

Repository files navigation

🐾 Tailmate – Pet Adoption App (Flutter + Web)

Tailmate is a cross-platform Flutter application that helps users discover and adopt pets. It offers a clean, responsive UI for both mobile and web platforms, with features like pet listing, pet details, favorites, and image handling.


✨ Features

  • 🐾 View a list of pets with images, age, and price.
  • ❀️ Mark pets as favorite for easy tracking.
  • πŸ“„ View detailed information about each pet with a clean UI.
  • 🌐 Responsive design optimized for both mobile and web platforms.
  • βš™οΈ Hosted API on Vercel with mock JSON data for quick access.
  • 🧩 Smooth Hero animations and custom card clipping for a polished feel.
  • πŸ” CORS-enabled API integration to support Flutter Web.
  • πŸ’Ύ Efficient caching using Hive: pet data and images are stored locally to reduce API calls.
  • πŸ”„ Pull-to-refresh feature to manually update data from the API.

πŸ“Έ Screenshots

🏠 Home Page

Light Mode Dark Mode
Home Light Home Dark

🏠 Home Page Category

Light Mode Dark Mode
Home Category Light Home Category Dark

πŸ” Search Page

Light Mode Dark Mode
Search Light Search Dark

πŸ“‹ Search Results Filter

Light Mode Dark Mode
Search Result Light Search Result Dark

πŸ“‹ Search Results

Light Mode Dark Mode
Search Result Filter Light Search Result Dark

πŸ“‚ Drawer

Light Mode Dark Mode
Drawer Light Drawer Dark

❀️ Favorites Page

Light Mode Dark Mode
Favorites Light Favorites Dark

πŸ•“ Filter History

Light Mode Dark Mode
Filter History Light Filter History Dark

πŸ“„ Details Page

Light Mode Dark Mode
Details Light Details Dark

πŸŽ‰ Adoption Success

Light Mode Dark Mode
Details Light Details Dark

🌐 Live Web Demo

πŸ‘‰ Try the Web App (Hosted on Vercel)


πŸ“¦ APK & Code


πŸ› οΈ Tech Stack

  • Frontend: Flutter (Dart)
  • Backend: Node.js (Vercel Serverless Functions)
  • State Management: flutter_bloc
  • Hosting: Vercel (API & Web)
  • Storage: JSON file-based mock data

πŸ—‚οΈ Folder Structure

    
tailmate/
β”‚
β”œβ”€β”€ lib/
β”‚ β”œβ”€β”€ cubits/
β”‚ β”œβ”€β”€ models/
β”‚ β”œβ”€β”€ screens/
β”‚ └── widgets/
β”œβ”€β”€ build/web/ # Web output folder (for hosting)
β”œβ”€β”€ api/ # Vercel serverless backend
β”œβ”€β”€ data/pets.json # Mock pet data
β”œβ”€β”€ pubspec.yaml
└── README.md
    

πŸ§ͺ Run Locally

# Clone the repo
git clone https://github.com/yourusername/tailmate.git
cd tailmate

# Get dependencies
flutter pub get

# Run on Android
flutter run

# Run on Web
flutter run -d chrome

# Build for Web
flutter build web

☁️ Deployment Notes

  • Only the build/web folder is deployed to Vercel due to the 100MB limit.
  • Backend API is hosted via Vercel serverless functions inside /api.
  • A vercel.json is used to route API requests properly.

πŸ™ Acknowledgements

Thanks to Posha for the opportunity and for providing the assessment prompt. Built with ❀️ by Ashutosh Mishra.


πŸ“§ Contact

  • πŸ“§ Email: am3718440@gmail.com

  • πŸ”— LinkedIn: @thescriptrailoth

  • πŸ“± Phone: +91-8423979654

About

Tailmate is a cross-platform Flutter application that helps users discover and adopt pets. It offers a clean, responsive UI for both mobile and web platforms, with features like pet listing, pet details, favorites, and image handling.

Topics

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors