DK SaaS Documentation
=====================

.. raw:: html

   <section class="dk-hero">
     <div class="dk-eyebrow">DK Business Solutions · SaaS Platform</div>
     <h1>Build, manage and scale your business from one place.</h1>
     <p>Everything your customers, administrators and developers need to understand the DK SaaS platform, deploy ERP instances, connect integrations and work with the API.</p>
     <span class="dk-search-hint">⌕ &nbsp; Use the documentation search to find anything</span>
   </section>

Welcome to the **DK SaaS Documentation**. This starter content intentionally uses placeholder examples so you can replace the text, screenshots and links with your real product information.

Quick start
-----------

.. grid:: 3
   :gutter: 3

   .. grid-item-card:: 🚀 Getting Started
      :link: getting_started/index
      :link-type: doc

      Create your account, choose a plan and launch your first ERP instance.

   .. grid-item-card:: 📖 User Guide
      :link: user_guide/index
      :link-type: doc

      Learn how to manage instances, users, modules, billing, backups and monitoring.

   .. grid-item-card:: ⚙ Administration
      :link: administrator/index
      :link-type: doc

      Configure domains, security, resources and platform-level settings.

   .. grid-item-card:: 👨‍💻 Developer
      :link: developer/index
      :link-type: doc

      Integrate with the API, MCP server, webhooks and custom modules.

   .. grid-item-card:: 🔌 Integrations
      :link: integrations/index
      :link-type: doc

      Connect AI agents, M-Pesa and other external systems.

   .. grid-item-card:: 🛠 Troubleshooting
      :link: troubleshooting/index
      :link-type: doc

      Diagnose common account, API, provisioning and ERP issues.

Platform overview
-----------------

.. image:: _images/platform-overview.svg
   :alt: DK SaaS platform overview illustration
   :class: dk-visual

The example platform contains a customer portal, a provisioning layer, ERP instances, integrations and developer APIs. Replace this illustration with a real product screenshot when your UI is ready.

.. admonition:: Documentation placeholders
   :class: note

   The sample screenshots and values in this project are deliberately fictional. Edit the Markdown/RST files and replace the assets in ``_images/`` with your real screenshots.

Popular paths
-------------

* :doc:`getting_started/introduction`
* :doc:`getting_started/first-instance`
* :doc:`user_guide/instances`
* :doc:`developer/api/overview`
* :doc:`developer/mcp/overview`
* :doc:`integrations/ai-agents`

.. toctree::
   :maxdepth: 2
   :hidden:

   getting_started/index
   user_guide/index
   administrator/index
   developer/index
   integrations/index
   troubleshooting/index