first commit

godot_client/docs/README.md

@@ -0,0 +1,103 @@
+# Scene Documentation
+
+This directory contains specifications for building Godot scenes.
+
+## Workflow
+
+### 1. Read the Scene Spec
+Each scene has a detailed specification document in `scenes/` that includes:
+- Visual mockup
+- Complete node hierarchy
+- Exact node names (important!)
+- Step-by-step build instructions
+- Colors and styling
+- What the script will handle
+
+### 2. Build in Godot Editor
+Follow the spec to create the scene visually:
+- Add nodes in the specified hierarchy
+- Name them **exactly** as documented
+- Set properties as specified
+- Apply colors and styling
+
+### 3. Save the Scene
+Save to the location specified in the doc (e.g., `scenes/auth/login.tscn`)
+
+### 4. Notify
+Let Claude know the scene is ready
+
+### 5. Script Creation
+Claude will:
+- Create the `.gd` script file
+- Add all the logic and API integration
+- Attach it to your scene
+
+## Available Specs
+
+### Scenes
+- [Login Screen](scenes/login_screen.md) - User authentication
+
+### Components
+- CustomButton - See `scripts/components/custom_button.gd`
+- Card - See `scripts/components/card.gd`
+- FormField - See `scripts/components/form_field.gd`
+
+## Color Reference
+
+Quick reference for the theme colors:
+
+```
+Backgrounds:
+  Primary:   #1a1a2e (very dark blue-gray)
+  Secondary: #16213e (slightly lighter)
+  Card:      #1e1e2f (card backgrounds)
+
+Text:
+  Primary:   #e4e4e7 (light gray)
+  Secondary: #a1a1aa (medium gray)
+  Disabled:  #71717a (dark gray)
+
+Accent:
+  Gold:       #d4af37 (primary)
+  Gold Light: #f4d03f (hover)
+  Gold Dark:  #b8930a (pressed)
+
+Status:
+  Error:   #ef4444 (red)
+  Success: #10b981 (green)
+  Warning: #f59e0b (orange)
+
+Borders:
+  Default: #3f3f46
+  Accent:  #d4af37 (gold)
+```
+
+## Tips
+
+### Node Naming
+- Use exact names from the spec (case-sensitive!)
+- Names must match so the script can find them
+- Example: `EmailInput` not `email_input`
+
+### Styling
+- Use StyleBoxFlat for custom backgrounds
+- Set theme overrides in Inspector
+- Colors are specified as hex codes
+
+### Layout
+- Use Container nodes for automatic layout
+- Set Custom Minimum Size for spacing/sizing
+- Use Control nodes for spacers
+
+### Testing
+- Run the scene (F6) to preview
+- Check for errors in debugger
+- Verify all nodes are named correctly
+
+## Questions?
+
+Check the spec document for details. Each spec includes:
+- What nodes to create
+- What properties to set
+- Visual reference
+- Step-by-step instructions