https://github.com/pharaohmak/ship-handling-calculator

An offline mobile app designed to calculate ship handling parameters. The app is built using React Native and Expo, and is intended for use by ship captains, navigators, and other maritime professionals to accurately calculate various handling parameters.
https://github.com/pharaohmak/ship-handling-calculator

expo javasc react-native

Last synced: about 2 months ago
JSON representation

An offline mobile app designed to calculate ship handling parameters. The app is built using React Native and Expo, and is intended for use by ship captains, navigators, and other maritime professionals to accurately calculate various handling parameters.

• Host: GitHub
• URL: https://github.com/pharaohmak/ship-handling-calculator
• Owner: pharaohmak
• Created: 2022-05-26T11:45:56.000Z (over 3 years ago)
• Default Branch: master
• Last Pushed: 2025-08-14T00:20:46.000Z (2 months ago)
• Last Synced: 2025-08-14T02:29:44.933Z (2 months ago)
• Topics: expo, javasc, react-native
• Language: JavaScript
• Homepage: https://expo.dev/preview/update?message=ready%20for%20production%20-ios&updateRuntimeVersion=exposdk:51.0.0&createdAt=2024-11-06T02:29:55.851Z&slug=exp&projectId=584a2668-0dbf-4052-9ff1-c4d458ed5eb8&group=c4fa87a4-0a20-4563-b594-e2ea20edb2d1
• Size: 5.19 MB
• Stars: 0
• Watchers: 1
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md

Awesome Lists containing this project

README

          
# ⚓ Ship Handling Calculator - Offline Mobile App

An offline-first mobile app for maritime professionals to calculate key ship handling parameters with precision. Designed for **ship captains, navigators**, and marine engineers, this app enables accurate calculations without needing internet connectivity.

---

## 🚀 Features

- **📴 Offline Functionality**  

  Perform all calculations without an internet connection — ideal for sea operations.

- **📐 Comprehensive Ship Calculations**  

  Includes modules for:

  - Draft & Trim  

  - Hydrostatic Stability  

  - Turning Radius  

  - Stopping Distance  

  - And more...

- **🎛️ User-Friendly Interface**  

  Built with intuitive sliders, forms, and clean navigation to simplify input and result analysis.

- **⚙️ Customizable Settings**  

  Toggle units, change calculation methods, and tailor display settings to fit operational standards.

- **📊 Accurate & Visual Results**  

  Uses industry-standard marine formulas with potential visualizations to aid interpretation.

- **💾 Data Persistence**  

  Save and load previous calculations locally — your data is retained even after the app closes.

---

## 🛠️ Tech Stack

- **React Native** — Core framework for cross-platform mobile app development  

- **Expo** — Simplified development, testing, and deployment workflow  

- **AsyncStorage** — Offline storage to retain user data and calculations  

- **Custom Algorithms** — Accurate marine calculations based on hydrostatics & dynamics  

- **Material Design / HIG Principles** — Optimized UI/UX for both iOS and Android

---

## 🧪 Getting Started

Follow the steps below to run the app locally:

```bash

# 1. Clone the repository

git clone https://github.com/pharaohmak/ship-handling-calculator.git

# 2. Navigate to the project folder

cd ship-handling-calculator

# 3. Install Expo CLI (if not already installed)

npm install -g expo-cli

# 4. Install project dependencies

npm install

# 5. Start the app

expo start

```

## 🤝 Contributing

Contributions are welcome!

To contribute:

	1.	Fork this repository

	2.	Create a feature branch: git checkout -b feature/your-feature-name

	3.	Commit your changes: git commit -m 'Add your message here'

	4.	Push to your fork: git push origin feature/your-feature-name

	5.	Submit a pull request

Please include clear descriptions and reference related issues (if any).

⸻

## 📄 License

Distributed under the MIT License.

Feel free to use and adapt this project for your own needs.

⸻

## 📬 Contact

For questions, feedback, or collaboration inquiries:

📧 alchemist@sleepingpharaoh.com