SafeRouteProject - GitLite

KO | EN

gitlite — search

#video #dotnet #ai-agent #android #claude #data-science #large-language-models #hacktoberfest #mcp #monitoring

SafeRouteProject

(★ 13)

SafeRoute is a Flutter-based safety companion that combines route guidance, emergency SOS tools, disaster alerts, and community safety reporting to help users travel with more confidence and context

File Explorer

ZIP Download

# Use via CDN

jsDelivr

jsDelivr serves any public GitHub repository as a CDN with zero setup. Pick a version and a file to get a ready-to-paste link and snippet.

Version

File

Link

Example

Command Glossary

Commands referenced in this DOCs, explained below.

🔍

`flutter pub`

View Details ▼

Flutter's package manager.
Note: Packages are available on <https://pub.dev>.
See also: `flutter`.

flutter pub get

Download/Update all packages specified in `pubspec.yaml`:

flutter pub add {{package1 package2 ...}}

Add a package dependency to an app:

flutter pub remove {{package1 package2 ...}}

Remove a package dependency from an app:

🔍

`flutter`

View Details ▼

Google's free, open source, and cross-platform mobile app SDK.
Some subcommands such as `pub` have their own usage documentation.

flutter create {{project_name}}

Initialize a new Flutter project in a directory of the same name:

flutter doctor

Check if all external tools are correctly installed:

flutter channel {{stable|beta|dev|master}}

List or change Flutter channel:

🔍

`lib`

View Details ▼

The Microsoft Library Manager for creating and managing static libraries of object files.

lib /OUT :{{path\to\library.lib}} {{path\to\file1.obj path\to\file2.obj ...}}

Create a static library from object files:

lib /LIST {{path\to\library.lib}}

List the contents of a library:

lib {{path\to\library.lib}} {{path\to\file.obj}}

Add an object file to an existing library:

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

SafeRoute is a Flutter-based personal safety app focused on informed travel, faster emergency action, and community-driven location awareness. It brings together route guidance, disaster context, emergency contact workflows, and safety reporting in a single mobile experience.

## About the project

SafeRoute is a mobile safety companion that combines navigation, emergency SOS tools, disaster alerts, and community safety signals to help users move with more confidence and context.

## What it does

- shows routes and map context with Google Maps
- lets users rate places based on perceived safety
- highlights useful checkpoints such as hospitals and police stations
- supports emergency contact and SOS flows
- includes background-triggered safety features and alert handling
- surfaces environmental and disaster information from connected services
- stores app data with Firebase services

## Tech stack

- Flutter
- Dart
- Firebase Auth
- Cloud Firestore
- Firebase Storage
- Google Maps Platform
- OpenWeatherMap

## Project structure

```text
lib/
|-- core/
|   |-- constants/
|   |-- services/
|   `-- theme/
|-- features/
|   |-- auth/
|   |-- checkpoints/
|   |-- disaster/
|   |-- emergency/
|   |-- environment/
|   |-- home/
|   `-- journey/
|-- router/
|-- firebase_options.dart
`-- main.dart
```

## Local setup

```bash
flutter pub get
flutter run
```

## Local config

This repository is now set up so that sensitive runtime configuration stays out of tracked source files.

### API keys

Local-only files used by the app:

- `lib/core/constants/api_keys.local.dart`
- `web/google_maps_api.local.js`
- `android/local.properties`

Tracked template files:

- `lib/core/constants/api_keys.example.dart`
- `web/google_maps_api.example.js`

Example Android local property:

```properties
GOOGLE_MAPS_API_KEY=your_google_maps_key
```

### Firebase

Local Firebase configuration is expected from machine-specific files rather than committed app source.

Local-only files:

- `lib/firebase_options.local.dart`
- `android/app/google-services.json`

If you need to recreate them, regenerate the FlutterFire config or download the correct Firebase platform file for the project.

## Notes

- This repo is prepared for development and portfolio sharing, not one-click public deployment.
- Generated artifacts, old reports, temporary logs, and local key files have been removed from version control.
- If you clone this project on a new machine, you will need to restore the local config files before running the full app.

## License

This project is licensed under the MIT License. See [LICENSE](./LICENSE).