AwardWiz searches airlines for award tickets so you can fly like a king, remorse-free. http://awardwiz.com
- Searches all permutations of origins and destinations (direct flights only for now)
- See when low-fares are available (
X
,I
,O
, etc) vs cash-based fares (for Chase Ultimate Rewards) - Searches:
aa
,aeroplan
,alaska
,delta
,jetblue
,southwest
andunited
, along withskiplagged
andskyscanner
(currently disabled) for points-to-cash estimates - Scrapers used to obtain data usually avoid various anti-botting mitigations used by airlines and live tests are run twice-daily to make sure scrapers usually work
- Know when WiFi and/or lie-flat pods will be available
- Coming soon Get emailed when award space opens up
- Coming soon Automatically calculate region-based miles based on published award charts
The Typescript React-based frontend calls a Browserless backend to scrape airlines' award search pages with Puppeteer. Backend database for user prefs is Firebase. Vite is used as the dev server (pnpm start
), Vitest is used for tests (pnpm test
and pnpm test-scrapers
). UI framework is Ant Design. The recommended package manager is pnpm.
Source code formatting and acceptable patterns are highly opinionated and enforced via eslint. This is checked as a git commit hook but can also be run with pnpm run check
(also checks dependencies, and builds the page).
A few environment variables are used to start the server and frontend. These can be listed in a .env.local
file:
Required Variables
VITE_GOOGLE_CLIENT_ID
: A Google client ID with OAuth capabilities (used for identity of users). You can get this from your Firebase Auth instance (Authentication > Sign-in method > Google > Web SDK confirmation > Web client ID)VITE_FIREBASE_CONFIG_JSON
: Set to the config information (in JSON format with quoted attribute names) from 'Settings > Project settings > General' and scroll to the bottom and select Config for your web app. The format is:{"apiKey": "...", "authDomain": "...", ...}
VITE_BROWSERLESS_AWS_PROXY_URL
andVITE_BROWSERLESS_AWS_PROXY_API_KEY
: AWS API Gateway credentials for fronting Browserless. You can also just set the URL to your Browserless instance and the API key.
Optional Variables
VITE_USE_FIREBASE_EMULATORS
: When running locally, setting this totrue
will use the default Firebase emulators. Don't forget to start them usingfirebase emulators:start
.VITE_LOKI_LOGGING_URL
: The url to log scraper results to ex:https://123456:apikey@logs-prod3.grafana.net/loki/api/v1/push
VITE_LOKI_LOGGING_UID
: Customize the loki logging user id when calling logging scraper results (defaults tounknown
)VITE_SMTP_CONNECTION_STRING
required for sending email notifications (still in progress). This is used when usingpnpm run marked-fares-worker
. This is a secret and should not be publicVITE_FIREBASE_SERVICE_ACCOUNT_JSON
: Set to the full service account JSON without line breaks from 'Settings > Project settings > Service accounts' from when you created it. If you create a new one now, note the old one will be immediately disabled. The service account is used by workers. The format is:{"type": "service_account", "project_id": "awardwiz", "private_key_id": "...", ...}
. This is a secret and should not be public
You can start a local instance of Browserless using docker-compose up
.