We'll fetch top points of interest. Click “Map View” to see them on a map.
My Plan
Add places from the grid to build your plan.
Loading map…
Search for places first to see them as map markers
My Plan
Add places from the map or grid.
App Configuration
Settings
API Keys & Cloudflare Worker
Keys stored only in your browser's localStorage and sent only to your own Worker proxy.
Deploy plane-simple-worker.js to Cloudflare (5 min, no CLI needed, free account) — instructions inside that file.
Transfer Bonus Manager — keep these current to see live bonus indicators everywhere
Program
Transfers To
Bonus %
Expires
Active
✓ Saved
First-time setup
Getting Started
Follow these steps once — takes about 10 minutes, no technical knowledge required.
1
Create Cloudflare account
Free, no credit card
2
Deploy the Worker
Copy & paste, one click
3
Get Duffel API key
Free account, real flights
4
Get Google Places key
For maps & itinerary
5
Add keys to Settings
Paste & save
✓
You're live!
Real flights & maps active
Step 1 of 5
Create a free Cloudflare account
Cloudflare is a large internet company that provides a free service called Workers — mini programs that run in the cloud. We use one to securely connect Plane Simple to flight data. You won't be charged; the free tier covers 100,000 requests per day.
Enter your email and create a password. Click “Sign up” to confirm.
4
Check your email — click the verification link Cloudflare sends you
5
When asked about a domain, click “Skip” or “I don't have a domain”
💡 Tip: You're now on your Cloudflare Dashboard. Leave this tab open — you'll need it for Step 2.
Step 2 of 5
Deploy the Cloudflare Worker
A Worker is a tiny program that acts as a secure middleman between Plane Simple and flight data APIs. You don't need to understand the code — just copy and paste it.
1
In your Cloudflare Dashboard, click “Workers & Pages” in the left sidebar (it has a 📌 icon)
2
Click the orange “Create” button, then choose “Create Worker”
3
Give it any name — for example plane-simple-proxy — then click “Deploy”
4
Click “Edit code”. You'll see a code editor with some placeholder text.
5
Select all the text in the editor (Ctrl+A or Cmd+A), then delete it
6
Open the plane-simple-worker.js file that came with this app. Select all its text and copy it (Ctrl+C or Cmd+C)
7
Paste it into the Cloudflare code editor (Ctrl+V or Cmd+V), then click “Deploy”
8
Look at the top of the page — you'll see your Worker URL. It looks like: https://plane-simple-proxy.YOUR-NAME.workers.dev
9
Copy that URL — you'll paste it into Plane Simple Settings in Step 5
💡 Tip: Cloudflare free tier = 100,000 requests/day. That's enough for years of personal use.
Step 3 of 5
Get your Duffel API key
Duffel is the flight data provider that powers Plane Simple. A free account gives you access to real-time prices and availability from 300+ airlines.
Create a free account with your email. Verify your email when prompted.
3
Once logged in, click “Developers” or “API” in the left sidebar
4
Find the “API keys” section. You'll see a Test key (starts with duffel_test_) and a Live key.
5
For now, copy the Test key. It shows real flights & prices but payments aren't charged. When ready to book for real, switch to the Live key.
6
Save this key somewhere safe — you'll paste it in Settings (Step 5)
💡 Tip: The test key is safe to use — it shows real flight data but won't charge any cards. Perfect for exploring.
Step 4 of 5
Get your Google Places API key
This key powers the Itinerary planner — it lets Plane Simple find points of interest and show them on Google Maps. This step is optional; the app works without it using demo data.
Click the blue “Create Project” button. Name it anything, e.g. “Plane Simple”.
3
In the left menu, click “APIs & Services” → “Library”
4
Search for “Places API”. Click it, then click “Enable”.
5
Also enable “Maps JavaScript API” (same process) — this powers the interactive map with markers.
6
Go to “APIs & Services” → “Credentials” → click “+ Create Credentials” → “API key”
7
Your API key appears. Copy it. Google gives $200 free credit/month — plenty for personal use.
⚠️ Note: Google may ask for a billing account. You won't be charged unless you exceed the free $200/month credit, which is very unlikely for personal use.
When restricting your key by website, add: https://YOUR-PROJECT.pages.dev/* (you'll get this URL in Step 5b).
Step 5 of 5
Add your keys to Settings
You're almost there. Paste the keys you collected into the Settings fields. They're stored only in your browser — Plane Simple never sends them anywhere except your own Cloudflare Worker.
1
Click “Settings” in the left sidebar (or use the button below)
2
In “Cloudflare Worker URL”, paste your Worker URL from Step 2 (the one ending in .workers.dev)
3
In “Duffel API Key”, paste your Duffel key from Step 3 (starts with duffel_test_)
4
In “Google Places Key”, paste your Google key from Step 4 (optional)
5
Click “Save Keys”. The blue setup banner on the Search page will disappear — that means it's working!
✅ Success check: Go to Search Flights, enter a route like JFK → CDG and a date, then click Search. Real flight prices should appear within a few seconds.
💡 Getting a "Failed to fetch" error? This happens when opening the HTML file directly from your computer (a browser security restriction). The fix is to host the file online — see Step 5b below.
Step 5b — Hosting
Host on Cloudflare Pages (free)
Opening an HTML file directly from your computer blocks external connections for security reasons. Hosting it online (even just for personal use) fixes this instantly. Cloudflare Pages is free forever, requires no credit card, and you already have a Cloudflare account.
You only need to do this once. Your personal URL will look like: https://plane-simple.pages.dev
Click "Workers & Pages" in the left sidebar, then click the "Pages" tab at the top
3
Click "Create" → then choose "Upload assets" (not the Git option)
4
Give your project a name — e.g. plane-simple — then click "Create project"
5
You’ll see a file drop zone. Rename your plane-simple.html file to index.html first (just right-click the file → Rename), then drag it into the drop zone
6
Click "Deploy site". In about 30 seconds you’ll see a green success screen.
7
Click "Continue to project". Your site URL is shown at the top — it ends in .pages.dev. Open that URL in your browser — this is your permanent link to Plane Simple.
8
Go to Settings in Plane Simple, re-enter your keys, and click Save Keys then Test Connection. You should now see 🎉 Everything working!
💡 Updating the app in future: When you get a new version of plane-simple.html, rename it to index.html and go to your Pages project → "Create new deployment" → drop the file in. Your URL stays the same.
🔑 Re-enter your keys after first visit: Since the app stores keys in your browser’s local storage, you’ll need to paste them in once on the new .pages.dev URL. They stay saved after that.
🎉
You're live!
Plane Simple is connected to real flight data. Search any route for live prices, award availability, and real-time seat maps.
Keep in mind
Update bonuses
When transfer bonus promotions change, update them in Settings → Bonus Manager so your points comparison stays accurate.
Test vs. Live key
The Duffel test key shows real prices but won't process payments. Switch to your Live key only when ready to book.