Skip to main content

bazis-front

The frontend layer of Bazis, the JSON:API framework on Django + FastAPI + Pydantic. A product built on Bazis gets a React + TypeScript + Vite frontend whose contract is generated from its own backend and whose protocol code is copied from this package.

Status: first release (0.1.0). The API may change in the minor versions.

bazis-front is a Python package (pip install bazis-front, module bazis.contrib.front), released together with the other Bazis packages. It has no npm packages: its TypeScript code is shipped as package data and copied into the frontend of a product, which owns the copy and gets fixes through new versions of the package.

Part What it is State
assets/client The JSON:API protocol of Bazis in TypeScript, typed by the OpenAPI types generated from a product available
assets/react React hooks over the client and TanStack Query: lists, items, runtime schemas, mutations, forms bound to the runtime schema, the transits of bazis-statusy, the uploads of bazis-uploadable, the socket of bazis-ws, the tasks of bazis-bg, the background requests of bazis-async-request available
assets/template The frontend of a product: React, TypeScript, Vite, TanStack Query, Tailwind with shadcn/ui available
manage.py bazis_front init Creates the frontend of a product from the template, with copies of the client and the hooks and a lock, and the starters of its specs available
manage.py bazis_front contract Exports the contract of a product (contract/openapi.json, contract/contract.json), generates its TypeScript in the frontend and checks that both are up to date available
manage.py bazis_front check Validates the specs of a product (spec/: product, screens, design) against their JSON Schemas, each other and the contract available
assets/ui Components on shadcn/ui and Tailwind 4 over the hooks: layout, states, list, card, form, login (with the logins of bazis-authing), the status and the transits of bazis-statusy, the file field of bazis-uploadable, the notifications and the live queries of bazis-ws, the progress of a task of bazis-bg, the result of a background request, each with its contract test available
manage.py bazis_front add Copies components into the frontend of a product, with the assets they require available
assets/playwright Playwright helpers that run the steps of the scenarios through the data-bz marks of the screens available
manage.py bazis_front e2e Generates a Playwright test per scenario of the specs and checks that they are up to date available
manage.py bazis_front update Brings the copied assets to a new version of the package, merging them with the changes of the product available

The layers and the principles are described in docs/architecture.md. AI agents building a product read bazis/contrib/front/AGENTS.md.

License

Apache License 2.0, see LICENSE. The components of shadcn/ui in bazis/contrib/front/assets/ui/shadcn/ are under the MIT License of shadcn/ui, whose notice is in their headers.

Metadata

Release files for bazis-front 0.1.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for bazis-front 0.1.0
File Size Uploaded
bazis_front-0.1.0.tar.gz 694.5 kB Details

Built distribution (wheel)

Table of built distributions (wheels) for bazis-front 0.1.0
File Interpreter ABI Platform
bazis_front-0.1.0-py3-none-any.whl Python 3 none any Details

Total release size: 1.3 MB

Release files / bazis_front-0.1.0.tar.gz

Download URL bazis_front-0.1.0.tar.gz
Size 694.5 kB
Tags Source
SHA-256 checksum
How to use checksums
9118723f91779dec6d4c225a3de5d9982934fe51b972310d0d5446c071136b1d
BLAKE2b-256 checksum
How to use checksums
e90896110fbb5e3ac1b49e1ceb5ed41f68dcfb98eabb92d8787812c2eee81586
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via uv/0.13.1 {"installer":{"name":"uv","version":"0.13.1","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}

Release files / bazis_front-0.1.0-py3-none-any.whl

Download URL bazis_front-0.1.0-py3-none-any.whl
Size 585.4 kB
Tags Python 3
SHA-256 checksum
How to use checksums
2146c935cc1f8966995dcb5daee21d9913c5da2322b354b692a2842a1af3937b
BLAKE2b-256 checksum
How to use checksums
1483107c9b99eb925fc8b9ca83a082ecefbd8ae916f14140ba7424eb1e0d9d8d
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via uv/0.13.1 {"installer":{"name":"uv","version":"0.13.1","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}

Release history Release notifications | RSS feed

This release

0.1.0 This release

2 release files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page