Improve llms.txt

docs/api_reference/api_reference.py

@@ -101,7 +101,7 @@ def render_content(c):
     else: return c
 
 def create_doc_section(*content, title):
-    return lambda: Titled(H1(title,cls='mb-10'), *map(render_content, content))
+    return lambda: Div(Container(*map(render_content, content)))
 
 def string2code_string(code: str) -> tuple: return eval(code), code
 
@@ -119,6 +119,7 @@ def _card(i): return Card(H3(f'Card {i}'), P(f'Card {i} content'))
     return Slider(*[_card(i) for i in range(10)], items_cls='gap-10', uk_slider='autoplay: true; autoplay-interval: 1000')
 
 docs_sliders = create_doc_section(
+    H1("Carousel Sliders API Reference"),
     "Here is a simple example of a slider:",
     fn2code_string(ex_sliders_1),
     "Here is a slider with cards:",
@@ -155,6 +156,7 @@ def ex_links():
         A('Classic Link', cls=AT.classic),)
 
 docs_button_link = create_doc_section(
+    H1("Buttons & Links API Reference"),
     Div(id='button'), # for linking to in release post
     fn2code_string(ex_buttons),
     fn2code_string(ex_links),
@@ -170,6 +172,7 @@ def ex_theme_switcher():
     return Uk_theme_switcher()
 
 docs_theme_headers = create_doc_section( 
+    H1("Theme and Headers API Reference"),
    """
    To get headers with a default theme use `hdrs=Theme.<color>.headers()`.  For example for the blue theme you would use `hdrs=Theme.blue.headers()`.  The theme integrated together different frameworks and allows tailwind, FrankenUI, HighlighJS, and DaisyUI components to work well together.
    
@@ -278,6 +281,7 @@ def ex_other():
         CodeBlock("#This is a CodeBlock element\n\ndef add(a,b): return a+b"))
 
 docs_typography = create_doc_section(
+    H1("Typography API Reference"),
     P("Ready to go semantic options that cover most of what you need based on the HTML spec"),
     fn2code_string(ex_headings),
     fn2code_string(ex_semantic_elements),
@@ -319,6 +323,7 @@ def ex_toasts2():
     return Toast("Second Example Toast", alert_cls=AlertT.info)
 
 docs_notifications = create_doc_section(
+    H1("Alerts & Toasts API Reference"),
     H3("Alerts"),
     P("The simplest alert is a div wrapped with a span:"),
     fn2code_string(ex_alerts1),
@@ -352,6 +357,7 @@ def ex_containers():
 
 
 docs_containers = create_doc_section(
+    H1("Articles, Containers & Sections API Reference"),
     ArticleMeta,
     ArticleTitle,
     Article,
@@ -429,6 +435,7 @@ def team_member(name, role, location="Remote"):
     return Grid(*team, cols_sm=1, cols_md=1, cols_lg=2, cols_xl=3)
 
 docs_cards = create_doc_section(
+    H1("Cards API Reference"),
     H3("Example Usage"),
     fn2code_string(ex_card),
     (*fn2code_string(ex_card2_wide),'uk-visible@s'),
@@ -454,6 +461,7 @@ def ex_lists():
     return Grid(*lists)
 
 docs_lists = create_doc_section(
+    H1("Lists API Reference"),
     fn2code_string(ex_lists),
     ListT,
     title="Lists")
@@ -524,6 +532,7 @@ def ex_form():
             DivCentered(Button("Submit Form", cls=ButtonT.primary))))
 
 docs_forms = create_doc_section(
+    H1("Forms and User Inputs API Reference"),
     H3("Example Form"),
     P(f"This form was live coded in a 5 minute video ",
           A("here",href="https://www.loom.com/share/0916e8a95d524c43a4d100ee85157624?start_and_pause=1", 
@@ -571,7 +580,9 @@ def ex_modal():
               footer=ModalCloseButton("Close", cls=ButtonT.primary),id='my-modal'))
 
 docs_modals = create_doc_section(
+    H1("Modals API Reference"),
     H3("Example Modal"),
+    Subtitle("This is a subtitle"),
     fn2code_string(ex_modal),
     Modal,
     ModalCloseButton,
@@ -665,6 +676,7 @@ def ex_h_stacked_div():
     )
 
 docs_layout = create_doc_section(
+    H1("Layout (Flex and Grid) API Reference"),
     P("This page covers `Grid`s, which are often used for general structure, `Flex` which is often used for layout of components that are not grid based, padding and positioning that can help you make your layout look good, and dividers that can help break up the page", cls=TextPresets.muted_sm),
     H2("Grid"),
     fn2code_string(ex_grid),
@@ -714,6 +726,7 @@ def ex_dividerline():
     return DividerLine()
 
 docs_dividers = create_doc_section(
+    H1("Dividers API Reference"),
     Divider,
     DividerT,
     fn2code_string(ex_dividers),
@@ -815,6 +828,7 @@ def ex_tabs2():
             Li(A("Disabled", cls='uk-disabled'))))
 
 docs_navigation = create_doc_section(
+    H1("Navigation (Nav, NavBar, Tabs, etc.) API Reference"),
     H1("Nav, NavBar, DowDownNav, and Tab examples"),
     Divider(),
     H2("Nav"),
@@ -873,6 +887,7 @@ def ex_steps3():
     cls=(StepsT.vertical, "min-h-[400px]"))
 
 docs_steps = create_doc_section(
+    H1("Steps API Reference"),
     fn2code_string(ex_steps2),
     fn2code_string(ex_steps3),
     H1("API Docs"),
@@ -915,6 +930,7 @@ def body_render(k, v):
         body_cell_render=body_render)
 
 docs_tables = create_doc_section(
+    H1("Tables API Reference"),
     fn2code_string(ex_tables0),
     fn2code_string(ex_tables1),
     fn2code_string(ex_tables2),
@@ -952,6 +968,7 @@ def ex_iconlink():
         UkIconLink('chevrons-right', button=True, cls=ButtonT.primary))
 
 docs_icons_images = create_doc_section(
+    H1("Icons & Images API Reference"),
     H1("Avatars"),
     fn2code_string(ex_dicebear),
     DiceBearAvatar,
@@ -985,6 +1002,7 @@ def ex_applyclasses():
     return apply_classes('<h1>Hello, World!</h1><p>This is a paragraph</p>')
 
 docs_markdown = create_doc_section(
+    H1("Markdown + automated HTML styling API Reference"),
     fn2code_string(ex_markdown),
     P("This uses the `apply_classes` function, which can be used to apply classes to html strings"),
     apply_classes,
@@ -1001,6 +1019,7 @@ def ex_loading2():
     return Div(*rows, cls='flex flex-col gap-4')
 
 docs_loading = create_doc_section(
+    H1("Loading IndicatorsAPI Reference"),
     fn2code_string(ex_loading1),
     fn2code_string(ex_loading2),
     Loading,

docs/createllms.sh

@@ -1,16 +1,27 @@
 #!/usr/bin/env python3
 
 from fastcore.utils import *
+import httpx
 import api_reference.api_reference as api_reference
 def fname2title(ref_fn_name): return ref_fn_name[5:].replace('_',' | ').title() 
 
 def create_llms_txt():    
     # Get examples
     base = "https://monsterui.answer.ai"
     examples = [f for f in Path('examples').glob('*.py') if not f.name.startswith('__') and f.name.endswith('.py')]
-    example_links = [f"[{f.stem.title()}]({base}/{f.name[:-3]}/md)" for f in examples]
+    example_links = []
+    for f in examples:
+        content = httpx.get(f"{base}/{f.stem}/md").text
+        first_line = content.split('\n')[0].strip('# ').strip('"')
+        example_links.append(f"[{f.stem.title()}]({base}/{f.name[:-3]}/md): {first_line}")
+
+    # Get reference files with their H1 headings
     reference_fns = L([o for o in dir(api_reference) if o.startswith('docs_')])
-    api_links = [f"[{fname2title(f)}]({base}/api_ref/{f}/md)" for f in reference_fns]
+    api_links = []
+    for f in reference_fns:
+        content = httpx.get(f"{base}/api_ref/{f}/md").text
+        first_heading = content.split('\n')[0].strip('# ')
+        api_links.append(f"[{fname2title(f)}]({base}/api_ref/{f}/md): {first_heading}")
 
     # Create content
     content = [
@@ -20,15 +31,15 @@ def create_llms_txt():
 
 '''
         "## API Reference",
-        '- [API List](https://raw.githubusercontent.com/AnswerDotAI/MonsterUI/refs/heads/main/docs/apilist.txt)',
+        '- [API List](https://raw.githubusercontent.com/AnswerDotAI/MonsterUI/refs/heads/main/docs/apilist.txt): Complete API Reference',
         "",
         "## Examples",
         *[f'- {a}' for a in example_links],
         "",
-        "## Optional",
+        "## Optional", 
         *[f'- {a}' for a in api_links],
-        "- [Layout](https://monsterui.answer.ai/tutorial_layout/md)",
-        "- [Spacing](https://monsterui.answer.ai/tutorial_spacing/md)",
+        "- [Layout](https://monsterui.answer.ai/tutorial_layout/md): MonsterUI Page Layout Guide",
+        "- [Spacing](https://monsterui.answer.ai/tutorial_spacing/md): Padding & Margin & Spacing, Oh my! (MonsterUI Spacing Guide)",
     ]
 
     # Write to file

docs/examples/scrollspy.py

@@ -1,4 +1,4 @@
-"Scrollspy Example" 
+"MonsterUI Scrollspy Example application" 
 
 from fasthtml.common import *
 from monsterui.all import *

docs/getting_started/GettingStarted.md

@@ -1,4 +1,4 @@
-# MonsterUI
+# MonsterUI Getting Started
 
 ## Installation
 

docs/guides/Layout.ipynb

@@ -5,7 +5,7 @@
    "id": "09a2b6fa",
    "metadata": {},
    "source": [
-    "# Layouts\n",
+    "# MonterUI Page Layout Guide \n",
     "\n",
     "This guide will discuss 3 tools for laying out your app pages, Grid, Flexbox, and Columns.  This page will discuss the strengths and when to use each individually, and then a section for how to combine them for more complex layouts at the end.\n",
     "\n",

docs/guides/Spacing.ipynb

@@ -5,7 +5,7 @@
    "id": "ce15239f",
    "metadata": {},
    "source": [
-    "# Padding & Margin & Spacing, Oh my!\n",
+    "# Padding & Margin & Spacing, Oh my! (MonsterUI Spacing Guide)\n",
     "\n",
     "This guide will cover some essentials about how to properly space apps and what the differences are between:\n",
     "\n",