JourneyDeck

Every vehicle, location, journey, metric, artist, and recording shown here is fictional demo data. No personal location history is included.

What is JourneyDeck?

JourneyDeck turns everyday travel into a private, searchable story. It brings together where you went, how you got there, what you listened to, and the patterns that emerge over time.

Journeys can arrive automatically from a Tesla through Tessie or be recorded directly by the JourneyDeck Recorder on an iPhone. Both sources feed the same Timeline, Atlas, Memories, music views, and statistics.

JourneyDeck is currently a personal, single-household project—not a public hosted service.

Highlights

JourneyDeck's idea began on August 7, 2026, at 9:23 a.m., as a Tesla drive recorder and music journal. See the project origin for the original conversation and first repository milestones.

• Overview and Live — current vehicle state, latest journey, battery, range, recent music, and quick actions.
• Timeline — journeys, charging, songs, and stops arranged in chronological order.
• Memories — collect journeys into visual chapters such as road trips, weekends, seasons, and favorites.
• Atlas — explore places, routes, recurring patterns, and changes in your personal mobility graph.
• Journey Music — connect Spotify listening history to the miles where each song played.
• Statistics — mileage, energy, efficiency, drive time, music, Autopilot, and period comparisons.
• Privacy-aware sharing — generate journey cards without exposing a home address or exact private coordinates.
• Responsive access — use the hosted dashboard on desktop or mobile, or package the Windows desktop experience.

Record with Tesla—or just an iPhone

	Tesla + Tessie	JourneyDeck Recorder
Works with	A Tesla connected to Tessie	Any car, rental, walk, or road trip
Capture	Automatic telemetry import	Start and finish from the iPhone app
Data	Route, vehicle, battery, charging, efficiency, and drive metrics	GPS route, time, distance, and speed metrics
Background use	Cloud synchronization	Continues while the iPhone is locked
Offline behavior	Depends on the vehicle provider	Queues points safely and retries automatically

The two approaches can coexist. Recorder journeys are labeled clearly and appear alongside provider-imported journeys.

Memories made from the road

Build collections, combine them into larger Memories, attach photos, and revisit the routes and music that made a season or trip memorable.

JourneyDeck Recorder for iPhone

The Recorder is a small Expo iOS companion that captures background GPS without requiring a Tesla. It stores the private server key in iOS Keychain, keeps an offline SQLite queue, retries uploads safely, and creates a normal JourneyDeck journey when recording finishes.

Locking the phone is fine; force-quitting the Recorder stops iOS background location until the app is reopened.

Try the demo UI

The repository includes a privacy-safe mock server with fictional journeys and music. With Node.js 24 or newer:

git clone https://github.com/drumpat01/DriveOS.git
cd DriveOS
npm install
node tests/mock-web-server.mjs

Open http://127.0.0.1:8790 to explore the interface without connecting any accounts.

Run your own JourneyDeck

JourneyDeck is designed for a technically comfortable owner who wants to operate a private archive. A full setup needs:

1. A JourneyDeck server and SQLite or Turso database.
2. At least one journey source: Tessie for Tesla or the iOS Recorder for any vehicle.
3. Optional Spotify OAuth for listening history and journey soundtracks.
4. Optional place enrichment for friendlier destination names.

Choose the guide that matches your setup:

• Windows desktop installation
• Hosted Node, Atlas, and Turso architecture
• JourneyDeck Recorder setup and builds
• Security model

Development

Install dependencies and run the full validation suite:

npm install
.\tools\Test-DriveOS.ps1

README screenshots can be regenerated entirely from fictional fixtures:

node tools/capture-readme-screenshots.mjs

Architecture and migration notes live in docs/ARCHITECTURE.md and docs/MIGRATION-ROADMAP.md.

Who works on this repo

• Code changes are made by Claude Duet through pull requests.
• Quinn (Grok Bot team) tests each pull request before it is merged.
• Design comes from Iris (Grok Bot team).

Privacy and project status

• JourneyDeck contains sensitive location history and should remain behind strong authentication.
• Hosted secrets stay in the deployment environment; Recorder credentials stay in iOS Keychain.
• Local runtime data, credentials, logs, and generated databases are excluded from Git.
• The project is a personal beta and still assumes a trusted owner or household rather than public multi-user onboarding.

JourneyDeck is not affiliated with or endorsed by Tesla, Tessie, Spotify, Apple, Expo, Foursquare, OpenFreeMap, or OpenStreetMap. Product names and trademarks belong to their respective owners.