app framework

README.md

@@ -1,2 +1,55 @@
-# fletchIQ_
+# FletchIQ
 
+Cross-platform React Native + React Native Web skeleton for an archery scoring application.
+
+## Stack
+
+- Expo + React Native + React Native Web
+- TypeScript
+- React Navigation (native stack + bottom tabs)
+- Zustand for global state
+- Supabase placeholders for auth and storage
+
+## Project Structure
+
+```text
+src/
+  assets/
+  components/
+    common/
+  data/
+  hooks/
+  logic/
+    scoring/
+  navigation/
+  screens/
+    auth/
+    history/
+    modes/
+    rounds/
+    scoreboard/
+    target/
+  services/
+    auth/
+    storage/
+    supabase/
+  store/
+  theme/
+  types/
+```
+
+## Getting Started
+
+```bash
+npm install
+npm run web
+```
+
+You can also run `npm run android` or `npm run ios` once Expo dependencies are installed locally.
+
+## Next Implementation Steps
+
+- Replace the placeholder login/register actions with real Supabase authentication.
+- Add target plotting and arrow-by-arrow scoring logic inside `src/logic/`.
+- Persist round history and leaderboard data through Supabase.
+- Add icons, branding assets, and platform-specific polish.