A nautical-themed Fitbit smartwatch application for sailors and boaters. Track your speed over ground (SOG) and heading in real-time, right from your wrist.
- Real-time Speed Display - View your speed over ground in knots or MPH (tap to toggle)
- Heading Indicator - Visual compass showing your current heading in degrees
- Animated Wave Graphics - Nautical-themed wave animations
- Clock Display - Standard 12-hour time format
- Background Running - Continues tracking in the background
- Fitbit Versa 4 (atlas)
- Fitbit Sense 2 (vulcan)
access_location- For GPS speed and heading datarun_background- For continuous tracking
- Node.js (v14 or higher recommended)
- Fitbit SDK CLI
-
Clone the repository:
git clone https://github.com/che-effe/salty-dog.git cd salty-dog -
Install dependencies:
npm install
-
Build the application:
npm run build
-
Debug/deploy to your device:
npm run debug
- Launch the SaltyDog app on your Fitbit device
- Your current speed and heading will display automatically once GPS acquires a fix
- Tap the screen to toggle between knots and MPH
- The directional indicator rotates to show your current heading
salty-dog/
├── app/ # Device application code
│ ├── index.js # Main app logic
│ └── utils.js # Utility functions
├── companion/ # Phone companion app
│ └── index.js
├── resources/ # UI assets and views
│ ├── index.view # SVG layout
│ ├── styles.css # Styling
│ └── widget.defs # Widget definitions
├── settings/ # App settings page
│ └── index.jsx
├── build/ # Compiled output
└── package.json
| Command | Description |
|---|---|
npm run build |
Build the application |
npm run debug |
Launch Fitbit debugger for deployment |
@fitbit/sdk- Fitbit SDK (v6.1.0)@fitbit/sdk-cli- Fitbit CLI toolsfitbit-animate- Animation library
This project is private and unlicensed.
che-effe