Skip to content

DavidCibin/BoatingDay

Repository files navigation

BoatingDay! app icon

Overview

BoatingDay is a mobile app that helps users stay informed about the current weather and ocean tides based on their location. Whether you're planning a day out on the water or need up-to-date tidal data for a specific coastal area, BoatingDay offers a simple and user-friendly solution to access this information quickly.

Features and Functionality

  • Location-based Weather & Tides: The app uses the phone's GPS to get the user's current location and fetch weather data and ocean tides specific to that area.
  • Tidal Graphs: Displays high and low tide points, with corresponding times for the peak points.
  • Search Functionality: Users can search for any location (e.g., "Boston, MA") and get current weather data and today's tides for the nearest station.
  • Station Selection: In addition to the nearest station, users can select other tide stations within a 30 miles radius of their location to view tide data.

Installation and Setup

  1. Clone the repository and navigate to the project directory.
  2. Run npm install to install the dependencies or npx install if you have npx installed.
  3. Start the app with npm start or npx start.

There are no required API keys or environment variables needed for running the app.

Technologies Used

  • React Native: For building the app's mobile interface.
  • Axios: For fetching weather and tide data from external APIs.

Usage Instructions

  • On launch, the app automatically detects your location and fetches the current weather and tidal information.
  • You can manually search for a location by entering a city name (e.g., "Boston, MA").
  • To fetch data for your current location, simply tap the location icon image to retrieve real-time weather and tide information.
  • View high/low tide points, represented in both time and feet, on a tide graph.
  • Switch between nearby tide stations within a 50km radius for detailed local tide information.

Download

The user can download the BoatingDay app for Android by following the link below:

Installation Instructions for Android

  1. Download the APK file from the link above.
  2. Before installing, ensure that you have allowed installations from unknown sources in your device's settings. This can usually be found in Settings > Security > Unknown Sources.
  3. Locate the downloaded APK file using your file manager and tap on it to begin the installation.
  4. Follow the prompts to complete the installation.

Demo

iOS Android

Contribution Guidelines

Feel free to submit issues or pull requests to improve the app. We're always open to contributions that can enhance the user experience or optimize the app's performance.

Screenshots

Permission Loading Stations Main

Changelog

** Version 1.0.1 Replaced NOAA API date format from MM/DD/YYYY to YYYY-MM-DD.

** Version 1.0.2 Prevented unknown locations from being displayed. Switched to a flex layout

** Version 1.0.2 Prevent unknown locations from being displayed. Switched to a flex layout.

** Version 1.2.0 Introduced new app layout.

** Version 2.0 Users can now choose tide dates up to one year in the past or future.

** Version 3.0 Uses D3.js instead of React Native Chart Kit, as D3.js is more reliable and flexible.

About

No description, website, or topics provided.

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published