TechDesign.md template for AI coding projects

One tool per layer, one line each: App, Look, Data, Payments, Builds.

Download TechDesign.md

How to use this template

  1. Read the template. Inspect the full file below and decide which instructions match your project.
  2. Adapt it to your repo. Save it as TechDesign.md. Replace placeholders and update stack choices, paths and verification commands to match your repository.
  3. Check and commit. Review the diff. Test the listed commands and keep the file in version control so future changes can be reviewed.

Complete template

# Tech Design: [App name]

One heading per layer, one line each: the tool and why. Leave none open, or the agent picks for you.

## App

Expo + Expo Router, SDK [version]: one codebase for iPhone and Android.

## Look

StyleSheet with one theme file (colors, fonts, spacing, radius), light and dark.

## Data

[On the phone (expo-sqlite or AsyncStorage) / Supabase] and why.
Supabase? Row Level Security on every table, and only the publishable (anon) key in the app.

## Payments

[RevenueCat / none] and why.

## Builds

EAS: development build while you build, production build for the stores.