https://github.com/softwave-technology/geoshock
A mobile application that aims to be aware of earthquakes near.
https://github.com/softwave-technology/geoshock
expo-location expo-router react-native react-native-maps rest-api tailwindcss
Last synced: about 2 months ago
JSON representation
A mobile application that aims to be aware of earthquakes near.
- Host: GitHub
- URL: https://github.com/softwave-technology/geoshock
- Owner: Softwave-Technology
- License: mit
- Created: 2025-04-24T13:38:58.000Z (2 months ago)
- Default Branch: main
- Last Pushed: 2025-04-28T19:23:05.000Z (about 2 months ago)
- Last Synced: 2025-05-07T16:14:45.983Z (about 2 months ago)
- Topics: expo-location, expo-router, react-native, react-native-maps, rest-api, tailwindcss
- Language: TypeScript
- Homepage:
- Size: 1.8 MB
- Stars: 0
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# GeoShock πβ‘
GeoShock is a mobile application that displays recent earthquake information around the user's location, providing visual data on a map along with safety guidelines and updates. It helps users stay informed about seismic activities near them.
## Features
- π Real-time location tracking.
- π Latest earthquake data visualization on a map.
- πΊοΈ Markers and radius circles to indicate earthquake areas.
- π§ Comprehensive earthquake safety guidelines.
- π Smooth onboarding experience with swipable introduction screens.
- π± Responsive, minimalistic and modern UI.
- βοΈ Built for both Android and iOS platforms.
## Screenshots
## Installation
```bash
# Clone the repository
git clone https://github.com/fast1-labs/geoshock.git
# Navigate into the project directory
cd geoshock
# Install dependencies
npm install
# or
yarn install
# Run the app
npm start
# or
yarn start
```
## Usage
1. Open the app.
2. Grant location permissions.
3. View recent earthquakes around your location on the map.
4. Read important earthquake safety tips from the guide section.
5. Stay updated and prepared!
## Technologies Used
- **React Native** (with Expo)
- **TypeScript**
- **Tailwind CSS** (NativeWind for styling)
- **react-native-maps** for MapView and markers
- **react-native-swiper** for onboarding pages
- **External APIs** (for real-time earthquake data fetching)
## Project Structure
```bash
βββ assets/
β βββ data/ # App images, onboarding illustrations
βββ components/ # Reusable UI components
βββ app/ # Screen files like Home, About, Onboarding
βββ utils/ # Utility functions (fetchEarthquake, getLocation)
βββ types/ # TypeScript types and interfaces
```
## Contributing
We welcome contributions!
Feel free to open issues for suggestions or bug reports.
To contribute:
1. Fork the repository.
2. Create a new branch (`git checkout -b feature/YourFeature`).
3. Commit your changes (`git commit -m 'Add SomeFeature'`).
4. Push to the branch (`git push origin feature/YourFeature`).
5. Open a Pull Request.
## License
This project is licensed under the MIT License. See the [LICENSE](LICENSE) file for details.
## Contact
- Developer: **AnΔ±l YavaΕ**
- Email: **[email protected]**
- Project Repository: [GeoShock GitHub](https://github.com/fast1-labs/geoshock)
---
**Stay safe, stay informed with GeoShock!** πβ‘