starlette-admin-infinite-scroll

Infinite scrolling for the starlette-admin list view.

Scroll to the bottom of a list and the next page is appended to the table, keeping the current search, sort, filters, visible columns and page size. Appended rows are rendered by starlette-admin itself, so selection, bulk and row actions, row click navigation and inline editing keep working.

Install

pip install starlette-admin-infinite-scroll

Requires Python 3.11+ and starlette-admin 1.0+.

Usage

from starlette_admin.contrib.sqla import Admin
from starlette_admin_infinite_scroll import InfiniteScrollPlugin

admin = Admin(engine, plugins=[InfiniteScrollPlugin()])

Configure it through the constructor:

InfiniteScrollPlugin(
    views=["product", "order"],  # only these list views (default: all)
    exclude_views=["audit-log"], # keep these paginated
    root_margin="600px",         # start loading earlier (default: "400px")
    hide_pagination=True,        # hide page links (default: True)
    max_auto_pages=5,            # then show "Load more" (default: 0 = unlimited)
)

See docs/index.md for details, behavior notes and the JavaScript API.

Development

uv sync
uv run pytest
uv run python example/app.py  # demo at http://localhost:8000/admin/product/list

make lint, make format, make test and make build wrap the usual tasks.

Releasing

1. Bump __version__ in src/starlette_admin_infinite_scroll/__init__.py and add an entry to CHANGELOG.md.
2. Commit and push to main.
3. Create a GitHub release with the tag v<version> (e.g. v0.2.0).

Publishing the release runs publish.yml: CI, a check that the tag matches the package version, the build, the upload to PyPI via Trusted Publishing, and attaching the built files to the release.

License

MIT