🌎 Free Pass Porter 🛂

Welcome to the Free Pass Porter! Your one-stop shop for figuring out where you can jet off to without the hassle of visa paperwork. ✈️

🚀 Features

• 🔍 Check visa requirements for multiple passports
• 🧮 Combine passports for maximum travel freedom
• 🏝️ Discover new destinations you can visit visa-free
• 🎛️ Use filters to compare passport powers

🛠️ Tech Stack

This project is built with some serious React superpowers:

• ⚛️ React
• 📘 TypeScript
• ⚡ Vite
• 🧹 ESLint & Prettier
• 🃏 Jest & React Testing Library

Notable tools and libraries:

• 🌍 countries-list: For country data
• 🚩 country-flag-icons: To display country flags
• 📊 papaparse: For parsing CSV data
• 🎨 react-icons: For a wide variety of icons
• 🔽 react-select: For enhanced select inputs

🏗️ CI/CD Pipeline

We've got a slick CI/CD pipeline set up with GitHub Actions and Firebase Hosting:

graph LR
    A[Push to GitHub] -->|Trigger| B[GitHub Actions]
    B --> C{Run Tests}
    C -->|Pass| D[Build Project]
    C -->|Fail| E[Notify Developer]
    D --> F[Deploy to Firebase Hosting]
    F --> G[Site Live!]

Loading

Our pipeline ensures:

• 🧪 All tests pass
• 📊 Code coverage is at least 80%
• 🚦 Linting checks are green
• 🚀 Automatic deployment to Firebase Hosting

🚀 Getting Started

1. Clone this repo
2. Run pnpm install to grab all the goodies
3. pnpm dev to start your local server
4. Visit the dev URL shown on your console and start exploring!

(you can use pnpm as I do or any package manager like regular npm or yarn)

🧪 Testing

We take testing seriously around here. Run the tests with:

npm test
# or
yarn test
# or
pnpm test

Remember, we need that sweet 80% coverage to keep our CI/CD pipeline happy!

🤝 Contributing

Got ideas? Found a bug? We're all ears! Feel free to open an issue or submit a PR.

Make sure to successfully run:

npm prebuild
# or
yarn prebuild
# or
pnpm prebuild

This will run linting checks and ensure test coverage meets our standards.

📜 License

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

🙌 Acknowledgments

• Huge thanks to Ilya Ilyankou's passport-index-dataset for providing the valuable passport data that powers this application
• Shoutout to all the passport-wielding globetrotters out there
• Thanks to the amazing open-source community for the tools that made this possible

Now go forth and travel the world! 🌍🌎🌏