dj-hyperview: A Django package for building mobile apps with Hyperview

[eamigo86]

Hi Hyperview community,

First, thank you to the maintainers and contributors for creating Hyperview and continuing to support it. It has been a genuinely interesting way to build server-driven native interfaces. I also appreciate how quickly the team responds to reported issues and works to resolve them.

I have published the first beta of dj-hyperview, a Django package that provides backend infrastructure for Hyperview applications while keeping every screen and product decision inside the consuming project.

Hyperview can work with any HTTP backend, but a Django application still needs reliable conventions for locating and rendering HXML, returning full documents and fragments with the correct media types, validating templates, and keeping cached or database-backed screens consistent. dj-hyperview brings those pieces together using normal Django patterns.

The beta includes:

• filesystem, database, and custom template sources with explicit precedence;
• validated document and fragment responses, content negotiation, and CSRF;
• automatic XML and XSD 1.1 validation, including project-defined elements;
• optional HXML editing and validation in Django Admin;
• cache-aware publication and invalidation, including shared Redis backends;
• optional Redis-backed SSE hints for real-time resource updates, allowing clients to safely refresh only the affected resources.

It currently supports Python 3.12–3.14, Django 5.2 and 6.1, and targets the Hyperview 0.110.0 contract.

A minimal Django view looks like this:

from django.urls import path
from dj_hyperview import HyperviewTemplateView

urlpatterns = [
    path(
        "hyperview/home/",
        HyperviewTemplateView.as_view(template_name="screens/home.xml"),
    ),
]

The screens/home.xml template remains owned by the Django project. The package resolves, renders, validates, and returns it as Hyperview HXML.

I also built HyperTodo, an open-source test application with a Django backend and Expo/Hyperview mobile client. It is used to exercise file and database templates, fragment updates, Admin editing, caching, localization, native extensions, and realtime refresh behavior in a realistic application.

Links:

• PyPI
• Documentation
• Source code
• HyperTodo example project

This is the first beta, so I am especially interested in feedback about the public API, the getting-started experience, database/Admin workflows, and how the package fits real Django-backed Hyperview applications. It is not yet a claim of production readiness.

Thanks again for making Hyperview available to the community.

[hgray-instawork]

This looks really interesting @eamigo86 thanks for sharing! It's always great to see what the community does with Hyperview. I'll take a deeper look at the tool and the HyperTodo app and let you know if I have any thoughts or comments.