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: 2

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

   .. toctree::
      :hidden:
      :caption: Guides
      :maxdepth: 3

      guides/authoring/index
      guides/viewing/index
      guides/coordination/index
      guides/costing_and_scheduling/index
      guides/drawings/index
      guides/facility_management/index
      guides/services/index
      guides/structural_analysis/index
      guides/troubleshooting
      guides/alignment
      guides/development/index
      tutorials/index
   .. toctree::
      :hidden:
      :caption: Reference
      :maxdepth: 2

      reference/general/index
      reference/toolbar/index
      reference/costing_and_scheduling/index
      reference/drawings_and_documents/index
      reference/facility_management/index
      reference/geometry_and_materials/index
      reference/object_information/index
      reference/project_overview/index
      reference/quality_and_coordination/index
      reference/services_and_systems/index
      reference/structural_analysis/index


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!