Skip to content

Dreamycloud-Studio/Pawsport

Repository files navigation

🐾 Pawsport – AI-Powered Pet Travel Assistant

📚 Documentation: All guides and implementation summaries are in the docs/ folder

Powered by AI License: MIT

For every pet who deserves a smooth journey—and a friend to boop at the end.


📖 About Pawsport

Moving across borders is stressful. Moving with a pet? That's a logistical nightmare.

Every year, thousands of pet owners face the daunting task of relocating their furry family members. The process is riddled with:

  • 🤯 Confusing Regulations: Varying rules for every country, airline, and transit point.
  • 📅 Strict Timelines: Miss a vaccination window by one day, and your pet can't fly.
  • 📄 Paperwork Overload: Health certificates, import permits, titer tests... the list never ends.
  • 😨 Anxiety: The fear of making a mistake that could leave a pet stranded in quarantine is real.

Pawsport was built to solve this. We believe that no pet parent should have to navigate this complex maze alone. By combining advanced AI with a supportive community, we turn a stressful relocation into a planned, manageable journey.


✨ Features

1. 🤖 Interactive AI Travel Assistant

Your 24/7 Expert Consultant

Powered by OpenAI, our intelligent assistant understands the nuances of pet travel.

  • Personalized Timelines: Generates a custom schedule based on your origin and destination.
  • Regulation Parsing: Explains complex requirements (like the 180-day wait period for Japan or rabies titer tests).
  • Plain-English Explanations: Understand why and when for every requirement.

2. 🐶 Nose Booper – Community Hub

Connecting Pet Travelers

Travel is better with friends. The "Nose Booper" connects you with:

  • Route Buddies: Find others traveling on similar routes.
  • Shared Experiences: Get advice from people who have successfully navigated specific customs offices.
  • Community Support: Share stories and "boops" with those who understand the journey.

3. 📋 Smart Planning Tools

Visualizing the Journey

  • Dynamic Checklists: Auto-generated based on your specific route and pet type.
  • Document Explainers: Simplified explanations for complex veterinary forms.
  • Visual Timelines: Track critical milestones to avoid travel delays.

🏗️ AI-Enhanced Development

Pawsport leverages modern generative tools to enhance the developer and user experience:

  • 👨‍💻 AI-Assisted Engineering: Developed with GitHub Copilot (powered by Claude 3.5 Sonnet) to ensure modern best practices and rapid implementation of complex features.
  • 📚 Interactive Intelligence: Utilizes OpenAI for parsing travel regulations and generating structured planning data.

🛠️ Technology Stack

  • Frontend: React 17 + TypeScript + Tailwind CSS
  • Backend: Node.js + Express (Serverless via Vercel)
  • Database & Auth: Supabase (PostgreSQL)
  • AI Integration: OpenAI GPT-4 / GPT-3.5-turbo
  • Deployment: Vercel (CI/CD)

🚀 Getting Started

To run Pawsport locally or deploy it yourself, please refer to our detailed guides:

  • DEVELOPMENT.md: Local setup, installation, and testing instructions.
  • DEPLOYMENT.md: Architecture details and Vercel deployment guide.
  • AI_SETUP.md: Configuring the OpenAI and Supabase integrations.

🤝 Contributing

We welcome fellow travelers and developers! Please check out our DEVELOPMENT.md to get started.


📝 License

This project is licensed under the MIT License - see the LICENSE file for details.


🙏 Credits

  • Inspired by our own pets who deserve the world.
  • Built with ❤️ for the global pet parent community.
  • Powered by technologies from OpenAI, Supabase, and Vercel.

Made with 🐾 by pet parents, for pet parents.

About

For every pet who deserves a smooth journey—and a friend to boop at the end.

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors