feat: initial project setup with implementation plan

- Add PLAN.md with 40-step checklist across 10 phases
- Add CLAUDE.md with project-specific instructions
- Set up nix flake with FastHTML/MonsterUI dependencies
- Create Python package skeleton (src/animaltrack)
- Vendor FastHTML and MonsterUI documentation
- Add Docker build configuration

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>

docs/vendor/monsterui/api_ref/docs_icons_images.md

@@ -0,0 +1,166 @@
+# Icons & Images API Reference
+
+# Avatars
+
+See Source
+
+See Output
+
+[code]
+
+    def ex_dicebear():
+        return DivLAligned(
+            DiceBearAvatar('Isaac Flath',10,10),
+            DiceBearAvatar('Aaliyah',10,10),
+            DiceBearAvatar('Alyssa',10,10))
+    
+[/code]
+
+### DiceBearAvatar
+
+Source
+
+[code]
+
+    DiceBearAvatar(seed_name: str, h: int = 20, w: int = 20)
+[/code]
+
+> Creates an Avatar using https://dicebear.com/
+
+**Params**
+
+  * `seed_name` Seed name (ie 'Isaac Flath')
+
+  * `h` Height
+
+  * `w` Width
+
+# PlaceHolder Images
+
+See Source
+
+See Output
+
+[code]
+
+    def ex_picsum():
+        return Grid(PicSumImg(100,100), PicSumImg(100,100, blur=6),PicSumImg(100,100, grayscale=True))
+    
+[/code]
+
+### PicSumImg
+
+Source
+
+[code]
+
+    PicSumImg(h: int = 200, w: int = 200, id: int = None, grayscale: bool = False, blur: int = None, **kwargs) -> fastcore.xml.FT
+[/code]
+
+> Creates a placeholder image using https://picsum.photos/
+
+**Params**
+
+  * `h` Height in pixels
+
+  * `w` Width in pixels
+
+  * `id` Optional specific image ID to use
+
+  * `grayscale` Whether to return grayscale version
+
+  * `blur` Optional blur amount (1-10)
+
+  * `kwargs`
+
+**Returns:** Img tag with picsum image
+
+# Icons
+
+Icons use Lucide icons - you can find a full list of icons in their docs.
+
+See Source
+
+See Output
+
+[code]
+
+    def ex_icon():
+        return Grid(
+            UkIcon('chevrons-right', height=15, width=15),
+            UkIcon('bug',            height=15, width=15),
+            UkIcon('phone-call',     height=15, width=15),
+            UkIcon('maximize-2',     height=15, width=15),
+            UkIcon('thumbs-up',      height=15, width=15),)        
+    
+[/code]
+
+### UkIcon
+
+Source
+
+[code]
+
+    UkIcon(icon: str, height: int = None, width: int = None, stroke_width: int = None, cls=(), **kwargs) -> fastcore.xml.FT
+[/code]
+
+> Creates an icon using lucide icons
+
+**Params**
+
+  * `icon` Icon name from lucide icons
+
+  * `height`
+
+  * `width`
+
+  * `stroke_width` Thickness of lines
+
+  * `cls` Additional classes on the `Uk_icon` tag
+
+  * `kwargs`
+
+**Returns:** a lucide icon of the specified size
+
+See Source
+
+See Output
+
+[code]
+
+    def ex_iconlink():
+        return DivLAligned(
+            UkIconLink('chevrons-right'),
+            UkIconLink('chevrons-right', button=True, cls=ButtonT.primary))
+    
+[/code]
+
+### UkIconLink
+
+Source
+
+[code]
+
+    UkIconLink(icon: str, height: int = None, width: int = None, stroke_width: int = None, cls=(), button: bool = False, **kwargs) -> fastcore.xml.FT
+[/code]
+
+> Creates an icon link using lucide icons
+
+**Params**
+
+  * `icon` Icon name from lucide icons
+
+  * `height`
+
+  * `width`
+
+  * `stroke_width` Thickness of lines
+
+  * `cls` Additional classes on the icon
+
+  * `button` Whether to use a button (defaults to a link)
+
+  * `kwargs`
+
+**Returns:** a lucide icon button or link of the specified size
+