https://github.com/hatstand/schengen
https://github.com/hatstand/schengen
Last synced: 8 months ago
JSON representation
- Host: GitHub
- URL: https://github.com/hatstand/schengen
- Owner: hatstand
- License: mit
- Created: 2025-06-05T14:25:45.000Z (about 1 year ago)
- Default Branch: main
- Last Pushed: 2025-08-28T14:57:15.000Z (10 months ago)
- Last Synced: 2025-08-28T21:50:38.684Z (10 months ago)
- Language: Dart
- Size: 125 KB
- Stars: 0
- Watchers: 0
- Forks: 0
- Open Issues: 2
-
Metadata Files:
- Readme: README.md
- License: LICENSE
- Codeowners: .github/CODEOWNERS
Awesome Lists containing this project
README
# Schengen Zone Tracker
A Flutter application to help travelers track their stays in the Schengen Zone.
## Features
- Track entry and exit dates in the Schengen Area
- Calculate days spent and days remaining based on the 90/180 day rule
- View stay history and statistics
- Receive notifications when approaching day limits
- Works offline with local data storage
## Getting Started
### Prerequisites
- Flutter SDK
- Android Studio or Xcode for device deployment
### Installation
1. Clone the repository
2. Run `flutter pub get` to install dependencies
3. Connect your device or start an emulator
4. Run `flutter run` to launch the application
## Development
### Architecture
- Flutter state management via Provider
- Local storage with SQLite
- Time Machine package for accurate date handling
- Cross-platform UI components
### Testing
Run the test suite with:
```bash
flutter test
```
### CI/CD Pipeline
This project uses GitHub Actions for automated builds and testing:
- **Continuous Integration**: Every PR and push to main/master branches triggers tests and analysis
- **Automated Builds**: Android APK is built for every PR and push to main
- **Releases**: Tagged versions (e.g., v1.0.0) trigger a GitHub Release with APK artifacts
## Development Resources
- [Flutter Documentation](https://docs.flutter.dev/)
- [Schengen Calculator Rules](https://ec.europa.eu/home-affairs/policies/schengen-borders-and-visa/border-crossing/short-stay-visa-calculator_en)
- [Time Machine Documentation](https://pub.dev/packages/time_machine)