Learn Bonsai
============

Discover `Bonsai <https://bonsaibim.org>`__, an add-on for beautiful, detailed,
and data-rich OpenBIM with Blender :)

.. image:: images/bonsai-rabbit.png
   :class: transparent

.. only:: builder_html and (not singlehtml)

   .. container:: toc-cards

      .. container:: card

         :doc:`/quickstart/introduction_to_bim` (2 minute read)
            Discover how Bonsai can model and describe our built environment
            using Building Information Modeling.

      .. container:: card

         :doc:`/quickstart/installation` (5 minute process)
            Install Blender and Bonsai on your computer. No administrator
            rights required!

      .. container:: card

         :doc:`/quickstart/explore_model` (15 minute tutorial)
            Open and view an IFC, and explore the most useful properties and
            relationships.

      .. container:: card

         :doc:`/quickstart/create_model` (20 minute tutorial)
            Begin modeling simple objects, walls, slabs, doors, and windows.

.. container:: global-index-toc

   .. toctree::
      :hidden:
      :caption: Quickstart
      :maxdepth: 1

      quickstart/introduction_to_bim
      quickstart/installation
      quickstart/explore_model
      quickstart/create_model
      quickstart/next_steps

   .. toctree::
      :hidden:
      :caption: Guides
      :maxdepth: 2

      guides/viewing/dealing_with_large_models
      guides/authoring/georeferencing
      guides/authoring/git_support
      guides/development/index
      guides/alignment
      guides/authoring/other_addons
      guides/troubleshooting
      guides/debugging

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

      reference/interface
      reference/topbar
      reference/properties

Need more help? Join the `live chat <https://osarch.org/chat/>`__ or `community
forums <https://community.osarch.org>`__. Something strange happening? Please
`report a bug <https://github.com/IfcOpenShell/IfcOpenShell/issues>`__. Want to
improve the software? Help with :doc:`coding </guides/development/getting_started>`  or `chip
in financially <https://opencollective.com/opensourcebim>`__. Every little bit
adds up!
