Dealproof docs
v1.0.0
Get help
● Documentation · Flutter · Node.js

Dealproof
from download to your own price book app.

Dealproof is an Android and iOS app that keeps a personal price book for any online shop and tells the user whether a discount is real. This guide takes you from the download to a branded build in the stores, step by step. Read it top to bottom the first time; after that, press / and search.

v1.0.0Flutter · Android · iOS 16+Optional Node.js 26 LTS serverOperator console

01What you bought

Dealproof is a complete, white-label mobile app source code plus an optional small server. The user saves prices from the shop pages they open (or from a shared link, a screenshot, a shelf tag or by typing). The Price Tape then shows three numbers side by side: the price the shop calls the old one, the lowest price the user saw in the last 30 days, and today's price, with a verdict: REAL LOW, NOT A REAL DEAL or NOT ENOUGH HISTORY. The app also has target prices, a Return-Window Guard, a Cycle Clock and a Pro tier sold through in-app purchases. All price data stays on the phone, and no sample data ships inside the app.

What it is not

Dealproof is not a deal finder, coupon app or affiliate app. It has no list of shops, no deals feed and no affiliate links. It only compares prices the user saved with the user's own history. Please describe your app the same way in your store listing.

PartFolderWhat it is
Mobile appapp/Flutter project for Android and iOS. Works fully offline, with no server.
Server (optional)server/Node.js backend with an operator console: change the paywall limits, features, verdict thresholds, return windows, release cycles, currency rates, announcements and force update without a new build; optionally confirm purchases with the stores.
Contractcontract/CONTRACT.mdThe three API calls between app and server, with example JSON.
Price Tape showing a NOT A REAL DEAL verdict
Price Tape · sample data

02Folder map

PathWhat is inside
app/lib/brand.dartApp name, tagline, accent colour, fonts, support/privacy/terms links, default store product ids, server address, share channel name. The one file for rebranding.
app/lib/src/Dart code: core/ (verdict, tape, page extractor, money, unit price, return window, cycle, CSV, config), data/ (SQLite store), services/ (controller, purchases, notifications, config client, ping), ui/screens/ (Book, Capture, Confirm, Product, Watch, Clock, Settings, Paywall, Onboarding, Update).
app/android/Android project and the small Kotlin MainActivity.kt that receives shared links.
app/ios/iOS project, PrivacyInfo.xcprivacy and the Swift app delegate.
app/assets/fonts/Fraunces, Hanken Grotesk and IBM Plex Mono fonts with their licence texts.
app/tool/make_icon.pyScript that draws the app icon.
app/test/Automated tests, including stored shop-page fixtures.
server/src/TypeScript server: app.ts (routes), purchases/ (App Store and Google Play checks), currency.ts, lists.ts (return windows and cycle clock), admin/manifest.ts (what the console shows).
server/packages/admin-kit/The operator console (MIKODES Admin Kit), licensed with this item.
server/.env.exampleEvery server setting, with comments.
server/DockerfileContainer build for the server.

03How it fits together

The app works alone. The server is optional: the app asks it for settings, can report an opt-in count, and can send a purchase proof for checking. Arrows point from the part that calls to the part that answers.

Dealproof architecture The phone app keeps the price book in a local SQLite database and reads shop pages the user opens. It calls three routes on the optional Node server: GET /v1/config, POST /v1/ping and POST /v1/purchases/verify. The server stores settings in SQLite, is managed through the operator console at /admin, fetches ECB reference rates if switched on, and calls the Apple App Store Server API and the Google Play Developer API to verify purchases. The app buys through the Apple and Google stores directly. Phone app (Android, iOS) Local SQLite price book, Price Tape, verdicts. Works fully offline. app/lib/ android/ ios/ Apple and Google stores In-app purchase: lifetime, yearly, restore (in_app_purchase). buy, restore Your server (optional) server/src/ Node.js, Hono GET /v1/config POST /v1/ping (opt-in) POST /v1/purchases/verify SQLite files in data/DATABASE_PATH Operator console Browser, /admin. Sign-in with two-factor. Paywall, rules, return windows, cycle clock. edits settings AppleApp Store Server API GooglePlay Developer API ECB (optional)daily reference rates Prices and products never leave the phone. Only the opt-in usage ping and the optional purchase checks go to your server.
Architecture: app, optional server, console and store APIs

04Quick start (about 20 minutes)

Windows users

Flutter runs natively on Windows: use PowerShell for the flutter commands and Android builds (iOS builds need a Mac). For the server, either install Node.js 22.12+ for Windows and use PowerShell (replace cp .env.example .env with Copy-Item .env.example .env; there is no openssl by default, so use WSL or any random 64-character hex string), or run the commands in WSL 2 (Ubuntu) or Docker. macOS and Linux users can ignore this note.

  1. Install Flutter 3.41 or newer (see Requirements) and run flutter doctor until it shows no red items for the platform you want.
  2. Run the app. In a terminal:
    cd app
    flutter pub get
    flutter test
    flutter run
    Connect an Android phone with USB debugging on, or start an iOS simulator.
  3. Run the server (optional).
    cd server
    cp .env.example .env
    openssl rand -hex 32        # paste the result after ADMIN_SECRET_KEY= in .env
    npm ci
    npm run build
    npm start
    Open http://localhost:8787/admin and follow First sign-in.
  4. Rebrand. Follow Rename and rebrand: name, package id, bundle id, icon, colours.
  5. Create the store products and put their ids in the app or the console: Store products.
  6. Build and publish: Release builds and signing.
Demo console

A read-only demo of the operator console: Email: demo@dealproof.demo · Password: dealproof-demo-2026 (read-only demo account)

05AI tools

AI tools were used to assist with parts of the code, documentation and graphics of this item. The finished product contains no AI features and calls no AI service.