From 5d4079579a2747129df1e50e2e0618a5f27a1ed0 Mon Sep 17 00:00:00 2001
From: beatzaplenty <wayne.bennett@live.com>
Date: Fri, 21 Nov 2025 15:08:49 +1000
Subject: [PATCH] 	new file:   Agents.md

---
 Agents.md | 31 +++++++++++++++++++++++++++++++
 1 file changed, 31 insertions(+)
 create mode 100644 Agents.md

diff --git a/Agents.md b/Agents.md
new file mode 100644
index 0000000..53a9d6a
--- /dev/null
+++ b/Agents.md
@@ -0,0 +1,31 @@
+Purpose
+
+StockFill is an offline-first Progressive Web App (PWA) designed to help service station staff create pick lists used to restock various store areas (drinks fridge, chips, chocolate, dairy, deli, etc.).
+It uses IndexedDB (Dexie) for local storage, no backend, and runs fully offline.
+
+All code generated must follow the architecture, conventions, and rules below.
+
+1. Core Architecture
+
+StockFill is:
+
+🟩 React + Vite
+
+🟩 PWA (service worker + manifest)
+
+🟩 Dexie.js for local DB (IndexedDB)
+
+🟩 React Router for navigation
+
+🟩 Context + Hooks for app logic
+
+🟩 Mobile-first UI
+
+🟩 Hosted via Docker using Nginx
+
+There is no remote API.
+All data stays local to the device.
+
+2. Directory Structure
+
+Codex must always generate files within this structure: