🚀

Quick Start

Start Here

Plan your first route in under two minutes:

1
Get a free Groq API key

Visit console.groq.com, sign up free (no credit card), create an API key. See the API Key guide.

2
Enter your API key

Paste into the GROQ API KEY field at the top. Status turns green and the bar auto-collapses after 1.5 seconds.

3
Set your route

Type your START — autocomplete suggests matching Australian towns as you type. Add your END and any + Add Via Town stops.

4
Choose your options

Pick overnight accommodation type, tick POIs, set traveller toggles, enter departure date and max daily km if needed.

5
Plan and Navigate

Click Plan My Route. Expand any day card and tap ↗ Drive A → B or scan the ▣ QR Code.

💡
Try a Quick Start route from the sidebar — Big Lap, Kimberley Explorer, Outback QLD, Great Ocean Road, or Red Centre. All waypoints pre-filled.
🔑

Getting Your Free Groq API Key

Required

This app uses Groq to power AI route planning. Groq's free tier covers thousands of plans per day — no credit card required.

Groq free tier — thousands of AI requests per day at zero cost.
1
Go to console.groq.com

console.groq.com

2
Create a free account

Sign up with Google, GitHub, or email. No credit card.

3
Go to API Keys → Create API Key

Name it RV Route Planner and click Submit.

4
Copy the key

It starts with gsk_ and appears only once — copy it immediately.

5
Paste into the app

The bar auto-collapses. Your key is saved in the browser for next time.

⚠️
Keep your key private. Stored only in your browser's local storage — sent only to Groq's servers when planning.
🗺️

Planning a Route

Fill in the left panel before clicking Plan My Route.

🔄
Trip Type

Big Lap, Regional Loop, Coastal Run, or Custom. Pre-fills sensible defaults.

📅
Departure Date

The AI uses this for seasonal advice, wet season warnings, and timing recommendations.

📏
Max Daily Drive

Optional km/day limit — the AI will not create legs longer than this.

🚐
Rig Type & Length

Sets road capability, beach access, and 4WD track suggestions automatically.

🏕️
Overnight Accommodation

Free Camp / Caravan Park / Hotel-Motel / Mixed. Affects POI suggestions and the budget estimate.

📝
Preferences & Notes

Free text — solar setup, fuel range, attractions, health considerations, anything.

💡
The Preferences field is the most powerful input. Mention your dog, need for dump points every 3 days, interest in specific regions, or maximum unsealed road comfort.
📍

Waypoints & Via Towns

Add towns to drive through — the AI creates a separate leg for each segment.

1
Type your start town

Autocomplete filters 500+ Australian locations as you type — including hinterland towns (Yandina, Maleny, Montville), outback stops (Birdsville, Daly Waters, Innamincka), and remote WA (Monkey Mia, Coral Bay, Gibb River Road). Include the state: Gladstone QLD.

2
Add via towns

Click + Add Via Town. Each creates a separate leg. Example: Gladstone → Clermont → Townsville creates two legs.

3
Set your end

If end = start, the app detects a Loop Route — distance is shown once (not doubled) with a 🔄 badge. The AI is also told not to double-count.

ℹ️
Up to 10 waypoints total. Keyboard: ↓↑ navigate · Enter or Tab to select · Escape to close.

Default start: Click ☆ Set Default on the START row to save your home base. Pre-fills automatically on every new session and restores after clearing a trip.

🌙

Overnight Stops

New

Two ways to control where the AI plans overnight stops:

Method 1 — Mark a waypoint town as overnight:

Every via town and the end destination has a 🌙 button. Click to toggle it as an overnight stop — becomes a solid 🌙 Night Stop pill. The AI prompt receives the towns listed and ensures leg endpoints land there with appropriate accommodation.

Method 2 — Pin a specific POI as overnight:

1
Expand any day card

Click a leg to open it.

2
Click 🌙 on the camp you want

The POI row turns indigo-tinted with a 🌙 Overnight badge on the name.

3
Only one pin per leg

Clicking another POI moves the pin. Click the pinned one to unpin.

💡
If no POI is pinned, the app auto-selects the best camp-type POI (or last POI) as the suggested overnight — shown with a lighter 🌙 badge. POIs at the origin/departure town are never shown.
🐕

Travelling With

New

Six toggle chips that add specific context to every AI request:

ToggleWhat it tells the AI
🐕 DogsDog-friendly camps and beaches, leash rules at national parks
🐱 CatsPet-friendly stops; quarantine zone notes
👧 KidsFamily-friendly activities, safe swimming, shorter legs
🧍 SoloCamps with other travellers, good phone coverage, safety notes
👫 CoupleCouple-focused suggestions, scenic and romantic stops
♿ AccessibleSealed paths, accessible facilities, avoid rough terrain
💡
Combine multiple toggles freely — a couple with dogs gets dog-friendly beach camps on well-maintained roads.

Points of Interest

Tick what you want — the AI includes each selected category in every leg. 15 categories total:

IconCategoryWhat it includes
Free CampsWikiCamps, rest areas, station stays, bush camping
🏕️Caravan ParksPowered sites, holiday parks, showgrounds with facilities
🌿National ParksNational parks and conservation areas
🚿Dump PointsGrey and black water disposal stations
Fuel StopsService stations and roadhouses with fuel
🍳RoadhousesOutback roadhouses and country diners
🏔️LookoutsScenic lookouts, gorges, viewpoints
💧SwimmingSwimming holes, waterholes, lagoons
🍷WineriesCellar doors, local produce markets
🛤️4WD TracksOff-road routes — auto-enabled when 4WD rig selected
🏛️HeritageHistoric sites, museums, missions
🚰Water RefillFresh water taps and tank refill points
🏟️ShowgroundsShowgrounds and saleyards with overnight caravan camping
🌊WaterfallsWaterfalls and gorges
🏖️BeachesCoastal access — adapted to rig (4WD rigs get beach driving; caravans get sealed access only)

Each POI has: 🌙 overnight pin · 📍 Maps search link · × delete. POIs are never shown at your origin/departure town.

🚐

Rig Capability Intelligence

New

Road advice, POI descriptions, and warnings adapt automatically based on your rig. A badge appears under Rig Type:

RigBadgeRoads4WD
Caravan🛣️ SealedSealed + graded gravel
Motorhome🛣️ SealedSealed preferred; watch height/weight
Campervan🔀 Gravel OKSealed + most graded gravel
Ute Canopy / Swag🛤️ 4WD CapableAll terrain — sandy, creek crossings✅ Full — auto-enables 4WD Tracks POI
Ute + Caravan (4WD)🛤️ 4WD CapableGraded unsealed + light 4WD — caravan limits extreme terrain✅ Light 4WD
5th Wheeler🛣️ SealedSealed only — check height, width, bridge limits
Pop-top🛣️ SealedSealed + well-maintained gravel
⚠️
After planning, if the route mentions unsealed or remote roads and your rig is sealed-only, an amber Road Suitability Check warning card appears in the results.
🚗

Vehicle & Fuel Calculator

Optional

Your vehicle profile saves automatically and reloads next visit — no need to re-enter every time.

1
Import from LogMyJourney AU

Click ⬇ Import from LogMyJourney — reads L/100km, tank size, and fuel type from the same browser. Profile saved automatically.

2
Or enter manually

Click ✏️ Enter Manually — L/100km, tank size, fuel type, rig name. Also saves automatically.

3
Set the fuel price

A regional estimate appears based on your start location (e.g. $2.85/L for Birdsville, $2.10/L for Brisbane). Adjust to your actual price and hit ↻ Recalculate or press Enter.

Towing penalty: If LogMyJourney detects a caravan/towing setup, +35% is applied to fuel consumption. Shown on the vehicle pill.

Regional price estimates — update automatically when your start location changes:

RegionDieselUnleaded
Very Remote (Birdsville, Uluru, Halls Creek)$2.85$2.75
Outback (Alice Springs, Mt Isa, Broome)$2.55$2.45
Far North QLD / NT (Cairns, Darwin)$2.35–2.40$2.28–2.32
Regional (Townsville, Ballarat, Dubbo)$2.22–2.25$2.15–2.18
Metro (Brisbane, Sydney, Melbourne)$2.10$2.05
ℹ️
Always verify with FuelCheck NSW or FuelWatch WA before going remote.
💰

Trip Budget Estimator

New

After planning, a green Trip Budget Estimate card shows a cost breakdown for the whole trip.

CostHow calculated
FuelYour L/100km × total km × fuel price (estimates 15L/100km if no vehicle set)
AccommodationFree Camp = $0 · Caravan Park = $55/night · Hotel/Motel = $160/night · Mixed = $28/night
Food$45/person/day self-catering — scales with traveller count
Activities$20/day for entry fees and attractions
⚠️
Estimates only — does not include maintenance, tours, ferries, national park passes, medication, or unexpected costs.
🗺️

Google Maps Links

↗️
Drive A → B

Clean A→B driving directions for that leg. Tap on mobile to launch Maps navigation directly.

🗺️
Open Full Route

All via towns as waypoints in one link. Google Maps supports max 8 waypoints.

📍
📍 Maps per POI

Opens a Google Maps search for that place — shows photos, hours, and reviews.

QR Code per leg

Scan with phone camera to open Maps. Plan on laptop at camp, scan in the morning.

⚠️
POI names are never used as route waypoints — only your actual via towns. This prevents the long encoded GPS-coordinate URLs.

QR Codes

Handy on the Road
1
Expand a day card → click ▣ QR Code

A modal opens with the leg's Maps URL encoded as a QR code.

2
Scan with your phone camera

Tap the banner → opens Google Maps navigation. No typing required.

3
Save the QR as PNG

Click ⬇ Save QR to download — print it or share to a travel companion.

💬

AI Chat

The AI Chat tab lets you ask follow-up questions. The input bar is at the top — type and press Enter or click Send. The AI has full context of your planned route.

Things to ask:

?
Fuel gaps

"Is there enough fuel between Camooweal and Tennant Creek?"

?
Dog-friendly camps

"Which free camps near Longreach allow dogs off-leash?"

?
Road conditions

"Is the Gibb River Road suitable for a 7.5m caravan in June?"

?
Seasonal advice

"Leaving in April — clockwise or counter-clockwise for the Kimberley?"

⚠️
Always verify fuel prices, road conditions, and campground availability with WikiCamps, Campermate, or state road authorities before going remote.

Pre-Departure Checklist

New

The ✅ Checklist tab has 40 items across 7 sections. Progress saves automatically and survives page reloads.

SectionItems
🚐 Rig & VehicleService, tyres, bearings, brakes, lights, hitches, seals (10)
⚡ Power & WaterSolar, batteries, gas, fresh water, grey water (7)
📄 Documents & InsuranceRegistration, insurance, roadside assist, towing compliance, licences, Medicare (7)
🧰 Safety & EmergencyPLB, UHF radio, first aid, fire extinguisher, spare tyre, recovery gear, water, snake kit (8)
📱 Navigation & TechHema Maps, Fuel Map app, satellite comms, dashcam, backup nav (6)
🍳 Kitchen & SuppliesFridge, pantry, cooking gear, dump hose, water hose, spares kit (6)
🐕 PetsVaccinations, registration, food, dog-friendly research, tick prevention (5)

Items tagged urgent are safety-critical. Items tagged important are highly recommended. Click Reset (top right of checklist) to start fresh.

📄

Export & Share

📄
Markdown

Downloads a .md file with your itinerary — open in Obsidian, Notion, or any text editor. Filename includes the date in DD-MM-YYYY format.

⚙️
JSON

Raw structured route data for importing into other apps or integrations.

📋
Copy Text

Full itinerary as plain text to clipboard — paste into messages, email, or notes.

🖨️
PDF

Opens the browser print dialog with a clean print layout — all day cards expanded, nav hidden. Save as PDF from the dialog.

🔗
Share Link

Generates a URL with your full plan encoded. Anyone opening it gets the route loaded. No server or account needed.

🗑️
Clear Trip

Resets route, chat, fuel, budget, overnight pins and waypoints. Keeps your saved default start and vehicle profile.

ℹ️
Share Link encodes the plan as base64 JSON in the URL hash — no server needed. Links can be long for complex routes. The hash is removed from browser history after loading.

Frequently Asked Questions

Does this cost money?
The app is free. Groq's free tier covers thousands of route plans per day — no credit card required.
Is my API key safe?
Stored only in your browser's local storage under rv_groq_key. Sent only to Groq's servers when planning. Never share it publicly.
The autocomplete isn't finding my town.
Type at least 2 characters and include the state abbreviation — e.g. Yandina QLD. Use ↓↑ to navigate, Enter to select. If your town isn't in the 500+ list, just type it in full — the AI plans to any Australian location.
Why does my loop trip show the distance once?
When start and end are the same town, the app detects a loop and labels the distance as Total Distance (Loop) with a 🔄 badge. The AI is instructed not to double-count the return distance.
Can I import my vehicle from LogMyJourney?
Yes — click Import from LogMyJourney. Reads triplog_settings from the same browser and device. Vehicle profile saves automatically and reloads next visit.
Why does the fuel price change when I type my start location?
The app uses remoteness-based regional estimates — Birdsville $2.85/L diesel, Brisbane $2.10/L. Always override with your actual servo price.
The Recalculate button isn't updating fuel costs.
The fuel price input requires you to press Enter or click away from the field before clicking Recalculate. You can also press Enter inside the price field to trigger recalculation directly. Make sure a vehicle is set first.
The Google Maps URL is very long and has GPS coordinates in it.
This was a bug in earlier versions where POI names were embedded as route waypoints. In the current version, only your actual via towns appear as waypoints. All POI links open as clean individual map searches.
The AI Chat isn't responding.
Check the API key status badge is green. The input bar is at the top of the chat panel — type and press Enter or click Send. An error message in the chat bubble will explain the issue (invalid key, rate limit, etc.).
Does this work offline?
No — AI planning requires internet to reach Groq's servers. Once planned, export as Markdown or JSON for offline reference. Save QR codes as PNG images before going remote.
Can I use this on my phone?
Yes — fully responsive. Planning is easier on a larger screen, but Maps links, AI chat, and QR code scanning all work on mobile. Plan on the laptop at camp, scan the QR in the morning to navigate.
🏕️
Safe travels! RV Route Planner AU is part of the Ian Fraser Vibe Coding portfolio — free tools for Australian caravan travellers at kbcianfa.github.io. Also check out LogMyJourney AU — the companion trip logging app.
☕ Buy me a coffee