Admin template override

admin_template.html   ← level 1: Runique contract (do not touch)
        ↓ extends
admin_base.html            ← level 2: default layout (can be replaced)
        ↓ extends
list.html / create.html …  ← level 3: CRUD components (can be replaced)

The developer can replace level 2 (global layout) and/or level 3 (individual pages).

Create a file that extends admin_template and fills the layout blocks.

templates/my_theme/admin_base.html

{% extends "admin/admin_template.html" %}

{% block extra_css %}
    <link rel="stylesheet" href="{{ "css/my_theme.css" | runique_static }}">
{% endblock %}

{% block sidebar %}
<nav class="my-sidebar">
    <h2>{{ site_title }}</h2>
    <ul>
    {% for res in resources %}
        <li>
            <a href="{{ admin_prefix }}/{{ res.key }}/list"
               {% if res.key == current_resource %}class="active"{% endif %}>
                {{ res.title }}
            </a>
        </li>
    {% endfor %}
    </ul>
</nav>
{% endblock %}

{% block topbar %}
<header class="my-topbar">
    {% block breadcrumb %}{% endblock %}
    <form method="POST" action="{{ admin_prefix }}/logout">
        {% csrf %}
        <button type="submit">{{ current_user.username }} — Logout</button>
    </form>
</header>
{% endblock %}

{% block extra_js %}
    <script src="{{ "js/my_admin.js" | runique_static }}" defer></script>
{% endblock %}

Note: admin/admin_template.html is the Tera key, not a file path.

RuniqueApp::builder(config)
    .with_admin(|a| a
        .templates(|t| t
            .with_list("my_theme/list.html")
            .with_create("my_theme/create.html")
            .with_edit("my_theme/edit.html")
            .with_detail("my_theme/detail.html")
            .with_delete("my_theme/delete.html")
            .with_dashboard("my_theme/dashboard.html")
            .with_login("my_theme/login.html")
            .with_base("my_theme/admin_base.html")
        )
    )
    .build().await?

To replace only the users list page:

templates/my_theme/users_list.html

{% extends "my_theme/admin_base.html" %}

{% block content %}
<h1>{{ resource.title }}</h1>
<p>{{ total }} entry(ies)</p>

{% for entry in entries %}
    <div class="user-card">
        <span>#{{ entry.id }}</span>
        <span>{{ entry.username }}</span>
    </div>
{% endfor %}
{% endblock %}