Skip to content

Dreamycloud-Studio/Pawsport

Repository files navigation

🐾 Pawsport – AI-Powered Pet Travel Assistant

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

Hackathon Ready Powered by AI

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


📖 The Story: Why 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 born 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.


✨ How It Helps: Feature Showcase

1. 🤖 Interactive AI Travel Assistant

Your 24/7 Expert Consultant

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

  • Problem: "I'm moving to Japan in 6 months. What do I do?"
  • Solution: The assistant generates a personalized timeline, explaining the critical 180-day wait period, rabies titer test requirements, and microchip standards. It doesn't just list rules; it explains why and when.

2. 🐶 Nose Booper – Community Hub

You Are Not Alone

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

  • Route Buddies: Find others flying from NYC to London on the same dates.
  • Local Experts: Get advice from people who have successfully navigated the specific customs office you'll be using.
  • Emotional Support: Share stories and "boops" with a community that understands the stress of pet travel.

3. 📋 Smart Planning Tools

Visualizing the Journey

  • Dynamic Checklists: auto-generated based on your specific route and pet type.
  • Document Explainers: Get plain-english explanations for complex veterinary forms.
  • Visual Timelines: See exactly when you need to visit the vet to avoid travel delays.

🏗️ Built With AI

Pawsport is not just an AI product; it's an AI-native project. We leveraged cutting-edge generative tools to accelerate every stage of development:

  • 👨‍💻 Code Generation: The codebase was architected and developed with GitHub Copilot (powered by Claude 3.5 Sonnet). From React components to serverless API functions, Copilot acted as our pair programmer, ensuring modern best practices and rapid iteration.
  • 🎥 Video Demo: Our promotional material and demo videos were generated using Veo and edited by Gemini, allowing us to visualize the user journey without an expensive production budget.
  • 📚 Documentation: All project documentation, including this README and our API specs, was written and refined with the help of Copilot and Gemini, ensuring clarity and comprehensive coverage.

🛠️ Technology Stack

  • Frontend: React 17 + TypeScript + Tailwind CSS (Custom styling)
  • Backend: Vercel Serverless Functions (Node.js)
  • AI Core: OpenAI GPT-3.5-turbo / GPT-4 via REST API
  • 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: Serverless architecture details and Vercel deployment guide.
  • AI_SETUP.md: Configuring the OpenAI integration.

🤝 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.


🙏 Acknowledgments

  • Inspired by our own pets who deserve the world.
  • Built with ❤️ for the global pet parent community.
  • Special thanks to the OpenAI and Vercel teams for enabling these capabilities.

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