{{ title_emoji | default("🚀") }} {{ project_name }} Documentation
{{ "=" * ((title_emoji | default("🚀") | length) + (project_name | length) + 14) }}

.. raw:: html

   <div class="hero-section">
     <h1 class="hero-title">{{ hero_title | default(project_display_name) }}</h1>
     <p class="hero-subtitle">{{ hero_subtitle | default("Modern Python package with intelligent defaults") }}</p>
   </div>

{{ overview_section | default("") }}

.. grid:: 2
   :gutter: 3
   :margin: 4

   .. grid-item-card:: :octicon:`rocket` Quick Start
      :link: quickstart
      :link-type: doc
      :class-card: sd-text-center
      
      Get up and running in under 5 minutes
      
   .. grid-item-card:: :octicon:`book` Examples
      :link: examples/index
      :link-type: doc
      :class-card: sd-text-center
      
      Step-by-step tutorials and code examples

   .. grid-item-card:: :octicon:`gear` API Reference
      :link: autoapi/index
      :link-type: doc
      :class-card: sd-text-center
      
      Complete Python API documentation
      
   .. grid-item-card:: :octicon:`tools` Configuration
      :link: configuration
      :link-type: doc  
      :class-card: sd-text-center
      
      Configuration options and customization

{% if features or key_features %}
Key Features
============

.. grid:: {{ features_columns | default(3) }}
   :gutter: 2
   :margin: 3

{% for feature in (features or key_features) %}
   .. grid-item-card:: {{ feature.icon | default("✨") }} {{ feature.title }}
      :class-card: sd-text-center sd-border-{{ feature.color | default("primary") }}
      
      {{ feature.description }}
      
{% endfor %}
{% endif %}

{% if what_is_section %}
What is {{ project_display_name }}? 🤔
{{ "=" * (12 + (project_display_name | length)) }}

{{ what_is_section }}
{% endif %}

{% if examples_section %}
Quick Examples
==============

{{ examples_section }}
{% endif %}

{% if installation_section %}
Installation
============

{{ installation_section }}
{% else %}
Installation
============

.. tab-set::

   .. tab-item:: pip

      .. code-block:: bash
         
         pip install {{ package_name }}

   .. tab-item:: Poetry

      .. code-block:: bash
         
         poetry add {{ package_name }}

   .. tab-item:: Development

      .. code-block:: bash
         
         git clone {{ repository_url | default("https://github.com/your-org/" + package_name) }}
         cd {{ package_name }}
         poetry install --with dev
{% endif %}

Getting Started
===============

.. button-ref:: quickstart
   :color: primary
   :class: sd-rounded-pill
   :expand:
   
   🚀 Get Started Now

.. button-ref:: examples/index  
   :color: success
   :class: sd-rounded-pill
   :expand:
   
   📚 Browse Examples

.. button-ref:: autoapi/index
   :color: secondary  
   :class: sd-rounded-pill
   :expand:
   
   📖 API Documentation

.. toctree::
   :maxdepth: 2
   :hidden:
   :caption: 📚 Documentation

   quickstart
   examples/index
   configuration
   troubleshooting
   changelog

.. toctree::
   :maxdepth: 2
   :hidden:
   :caption: 🔧 API Reference
   
   autoapi/index

.. toctree::
   :maxdepth: 1
   :hidden:
   :caption: 🔗 Links
   
   {% if repository_url %}GitHub Repository <{{ repository_url }}>{% endif %}
   {% if issues_url %}Issue Tracker <{{ issues_url }}>{% endif %}
   {% if community_url %}Community <{{ community_url }}>{% endif %}