Code_of_Conquest/godot_client/docs/README.md

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 - 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