docs: add homepage to docs

Author: S1M0N38

docs/index.md

@@ -0,0 +1,49 @@
+<figure markdown="span">
+  ![Image title](assets/balatrobot.svg){ width="256" }
+  <figcaption>A framework for Balatro bot development</figcaption>
+</figure>
+
+---
+
+BalatroBot is a Python framework designed to help developers create automated bots for the card game Balatro. The framework provides a comprehensive API for interacting with the game, handling game state, making strategic decisions, and executing actions. Whether you're building a simple bot or a sophisticated AI player, BalatroBot offers the tools and structure needed to get started quickly.
+
+<div class="grid cards" markdown>
+
+-   :material-download:{ .lg .middle } __Installation__
+
+    ---
+
+    Complete setup guide covering prerequisites, Steamodded mod installation,
+    Python environment setup.
+
+    [:octicons-arrow-right-24: Installation](installation.md)
+
+-   :material-robot:{ .lg .middle } __Bot Development__
+
+    ---
+
+    Learn to build Balatro bots, complete code examples,
+    class structure, game state handling.
+
+    [:octicons-arrow-right-24: Bot Development](bot-development.md)
+
+-   :material-api:{ .lg .middle } __API Protocol__
+
+    ---
+
+    Technical reference for UDP socket communication, message formats,
+    game states, action types.
+
+    [:octicons-arrow-right-24: API Protocol](api-protocol.md)
+
+-   :material-help-circle:{ .lg .middle } __Troubleshooting__
+
+    ---
+
+    Common issues and debugging solutions for bot development
+    and game integration problems (WIP).
+
+    [:octicons-arrow-right-24: Troubleshooting](troubleshooting.md)
+
+</div>
+

mkdocs.yml

@@ -30,11 +30,15 @@ theme:
 plugins:
   - search
 nav:
+  - index.md
   - Installation: installation.md
   - Bot Development: bot-development.md
   - API Protocol: api-protocol.md
   - Troubleshooting: troubleshooting.md
 markdown_extensions:
+  - attr_list
+  - md_in_html
+  - pymdownx.blocks.caption
   - admonition
   - pymdownx.details
   - pymdownx.highlight:
@@ -50,3 +54,6 @@ markdown_extensions:
           format: !!python/name:pymdownx.superfences.fence_code_format
   - pymdownx.tabbed:
       alternate_style: true
+  - pymdownx.emoji:
+      emoji_index: !!python/name:material.extensions.emoji.twemoji
+      emoji_generator: !!python/name:material.extensions.emoji.to_svg