==========
Quickstart
==========

Welcome to the Quickstart Guide! These interactive Jupyter notebooks are designed to get you up and running quickly. We recommend following them in order, from the fundamentals of JAX to running your very first end-to-end simulation.

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

   notebooks/quickstart/01_jax_introduction.ipynb
   notebooks/quickstart/02_basic_materials.ipynb
   notebooks/quickstart/03_object_placement_guide.ipynb
   notebooks/quickstart/04_basic_simulation.ipynb

.. grid:: 1 2 2 2
   :gutter: 3

   .. grid-item-card:: 🚀 1. Introduction to JAX
      :link: notebooks/quickstart/01_jax_introduction
      :link-type: doc

      New to JAX? Start here. Learn the basics of high-performance array computing, automatic differentiation, and how it powers FDTDX.

   .. grid-item-card:: 🎨 2. Basic Materials
      :link: notebooks/quickstart/02_basic_materials
      :link-type: doc

      Discover how to define physical materials. Learn about different material types and their differences.

   .. grid-item-card:: 🏗️ 3. Object Placement Guide
      :link: notebooks/quickstart/03_object_placement_guide
      :link-type: doc

      This guide covers how to programmatically position, orient, and manage objects in your simulation scene.

   .. grid-item-card:: ⚙️ 4. Basic Simulation
      :link: notebooks/quickstart/04_basic_simulation
      :link-type: doc

      Bring it all together. Set up your simulation scene, step through time, and run your first simulation.