BIEKIT
======

.. rst-class:: lead

   A lightweight **C++20** boundary integral equation toolkit (standard library only).

.. admonition:: Status
   :class: note

   This documentation is **work in progress** and the project is currently **closed-source**.

What is BIEKIT?
---------------

BIEKIT is a small, opinionated toolkit for building boundary integral equation (BIE) solvers in modern C++.

* Focus: clear abstractions for meshes, function spaces, operators, and solvers
* Targets: Laplace / Helmholtz / Maxwell-style formulations
* Style: standard library only (no heavy runtime dependencies)

Quick links
-----------

.. grid:: 2
   :gutter: 2

   .. grid-item-card:: 🚀 Getting Started
      :link: getting-started
      :link-type: doc

      Install doc deps, build the site, and learn the workflow.

   .. grid-item-card:: 🧭 Tutorials
      :link: tutorials/index
      :link-type: doc

      End-to-end guides (Laplace / Helmholtz / Maxwell).

   .. grid-item-card:: 📚 Reference
      :link: reference/index
      :link-type: doc

      Naming, glossary, and design notes.

   .. grid-item-card:: ℹ️ About
      :link: about
      :link-type: doc

      Author, acknowledgements, licensing notes.

A tiny math check
-----------------

Inline math: :math:`\nabla \cdot \mathbf{J} = 0`.

A numbered equation (refer to it as :eq:`eq-maxwell-ampere`)::

.. math::
   :label: eq-maxwell-ampere

   \nabla \times \mathbf{H} = \mathbf{J} + \frac{\partial \mathbf{D}}{\partial t}

Contents
--------

.. toctree::
   :maxdepth: 2
   :caption: Contents

   getting-started
   tutorials/index
   reference/index
   about