Waton Documentation
===================

.. container:: waton-hero-shell

   .. container:: waton-kicker

      WhatsApp Multi-Device Python SDK

   **Build WhatsApp workflows with a modern Python-first stack.**

   Waton combines high-level DX with Rust-backed crypto internals so you can move
   fast without sacrificing protocol fidelity. From quickstart to production
   operations, this docs site is structured as a practical developer portal.

   .. container:: waton-hero-links

      * `GitHub Repository <https://github.com/kaivyy/waton>`_
      * :doc:`Getting Started <content/getting-started>`
      * :doc:`App Quickstart <content/quickstart-app>`
      * :doc:`Troubleshooting <content/faq-troubleshooting>`

.. note::

   **Best path for new users:** Start with :doc:`content/getting-started`, then continue to
   :doc:`content/quickstart-app` for the first production-style integration.

.. list-table::
   :class: waton-feature-grid
   :widths: 1 1

   * - .. container:: waton-feature-card

          **Start Here**

          Setup, first run, and dashboard-assisted development.

     - .. container:: waton-feature-card

          **Core Concepts**

          Architecture, lifecycle, events, and message model fundamentals.

   * - .. container:: waton-feature-card

          **How-to Guides**

          Practical workflows from handling messages to group operations.

     - .. container:: waton-feature-card

          **Reference**

          Configuration and API references when you need exact details.

.. toctree::
   :maxdepth: 2
   :caption: Start Here

   content/getting-started
   content/quickstart-app
   content/quickstart-low-level
   content/browser-dashboard

.. toctree::
   :maxdepth: 2
   :caption: Core Concepts

   content/core-concepts
   content/connection-lifecycle
   content/event-model
   content/message-model

.. toctree::
   :maxdepth: 2
   :caption: How-to Guides

   content/handling-messages
   content/sending-messages
   content/groups
   content/privacy-and-chats
   content/app-state-and-history-sync
   content/business-and-newsletters

.. toctree::
   :maxdepth: 2
   :caption: Reference

   content/config-reference
   content/app-framework-reference
   content/client-api-reference
   content/dashboard-api-reference

.. toctree::
   :maxdepth: 2
   :caption: Support & Operations

   content/testing
   content/faq-troubleshooting
   content/migration-and-compatibility
   content/readthedocs