Configuration
one document, four layers.

01Two places, one rule

02Your domain (TIDE_HOST)

Default: tide.mikodes.com. Pass your own host (no https://) on every run and build:

flutter run -d chrome --dart-define=TIDE_HOST=app.example.com
flutter build web --release --dart-define=TIDE_HOST=app.example.com

If you set Support email, Website, Terms URL or Privacy URL in the operator panel, the app uses those and ignores the derived value. The Android https referral link has its own host in AndroidManifest.xml (Rebranding → Deep links).

03The four layers

Weakest first. The strongest layer that supplies a value wins that value, leaf by leaf (lib/core/config/config_layers.dart).

Operator panel → In force right now lists every value the app is running on and which layer it came from.

04The document

This is the full shape, with the shipped defaults. Operator panel → Copy as JSON gives you the same shape with your values (only the ones you changed).

{
  "config_version": 1,
  "app_name": "TIDE",
  "tagline": "Swap on Solana. See what other wallets did.",
  "support_email": "",
  "website_url": "",
  "terms_url": "",
  "privacy_url": "",
  "announcement": "",
  "min_app_version": "",
  "default_slippage_pct": 1.0,
  "admin_locked": false,
  "flags": {
    "swap_enabled": true,
    "feed_enabled": true,
    "watchlist_enabled": true,
    "profiles_enabled": true,
    "realised_standings_enabled": true,
    "push_enabled": false,
    "referral_enabled": false,
    "cashback_enabled": false,
    "evm_chain_enabled": false,
    "copy_execution_enabled": false
  },
  "fee": {
    "fee_enabled": false,
    "fee_bps": 0,
    "min_fee_usd": 0,
    "solana_fee_wallet": "",
    "evm_fee_wallet": ""
  },
  "referral": {
    "referral_enabled": false,
    "tiers": 0,
    "tier1_share_bps": 0,
    "tier2_share_bps": 0,
    "payout_threshold_usd": 0
  },
  "cashback": {
    "cashback_enabled": false,
    "tiers": []
  },
  "keys": {
    "helius_api_key": "",
    "zerox_api_key": "",
    "solana_rpc_url": "",
    "evm_rpc_url": ""
  },
  "extra_restricted_regions": []
}

An unknown flag key is ignored. A region code that is not two letters is dropped. Every rate is clamped to its code cap on the way in (caps).

05Feature switches

06Endpoints and keys

07Remote document for many installs

The panel changes only the device it runs on. To give every install the same configuration:

1. Configure one buildSet everything in the operator panel.
2. Copy the documentOperator panel → Copy as JSON.
3. Add the lockAdd "admin_locked": true to the document, so users cannot change the fee on their own phones.
4. Host itAny HTTPS static file works, for example https://<your-domain>/tide-config.json.
5. Wire a fetcherThis is the one code change in the install. In lib/main.dart, pass fetchRemote to AdminConfigService:

   // lib/main.dart — add at the top:
   import 'dart:convert';
   import 'package:http/http.dart' as http;
   
   // replace AdminConfigService(store: adminStore) with:
   AdminConfigService(
     store: adminStore,
     fetchRemote: () async {
       final r = await http.get(Uri.parse('https://<your-domain>/tide-config.json'));
       if (r.statusCode != 200) return null;
       return jsonDecode(r.body) as Map<String, dynamic>;
     },
   ),

6. Rebuild and releaseFrom then on you change the hosted file; the app reads it on each start.

With admin_locked the panel becomes read-only on every install and says why. Without it, the device's own panel values win, which is what you want while you are the only user. The snippet passes flutter analyze against 0.1.0; the URL is yours to fill in. Firestore or Remote Config work the same way: return the document as a map.

08Push notifications and Firebase (optional)

TIDE works without Firebase and ships no Firebase files. Push is a keyless hook: PushNotificationService in lib/core/notifications/push_notification_service.dart accepts a tokenProvider you supply. To use Firebase: create your own project, add the firebase_core and firebase_messaging packages, run flutterfire configure, initialise Firebase in lib/main.dart, and pass tokenProvider: () => FirebaseMessaging.instance.getToken(). Sending pushes needs a server or the Firebase console; TIDE includes none. These steps are from docs/FIREBASE-SETUP.md and were not run for these docs.

If you store config in Firestore, keep it read-only for clients and never store a wallet address next to a referral code (why).

09Where data is stored

There is no server and no database. Nothing is uploaded.