# AJSF

> AJSF (Angular JSON Schema Form) builds Angular forms from a JSON Schema, published as @ajsf/core plus framework packages for Angular Material, PrimeNG, Bootstrap 3, Bootstrap 4 and Bootstrap 5.

From 14.0.0 onward, the package major equals the Angular major it targets: @ajsf/* 22.x is for Angular 22. JSON Schema drafts 4, 6 and 7 are supported (drafts 1 to 3 were dropped in 19.0.0); 2019-09 and 2020-12 are not.

## Docs

- [README](https://github.com/hamzahamidi/ajsf#readme): what AJSF is, the six packages, and how to render a form with the json-schema-form component
- [Installation](https://github.com/hamzahamidi/ajsf#installation): which package to install for each UI library, the Angular Material peers (@angular/material and @angular/cdk), importing the framework module in a standalone component (or an NgModule), the production bundle budget, and a link to the separate PrimeNG setup guide
- [Version compatibility](https://github.com/hamzahamidi/ajsf#version-compatibility): how @ajsf majors map to Angular majors
- [JSON Schema versions](https://github.com/hamzahamidi/ajsf#json-schema-versions): supported drafts and known limits
- [API reference](https://hamidihamza.com/ajsf/api/): generated from the public_api.ts entry point of each package

## Release notes

- [GitHub releases](https://github.com/hamzahamidi/ajsf/releases): one page per @ajsf release from v14.0.0
- [Major upgrade notes](https://github.com/hamzahamidi/ajsf/tree/main/docs/release-notes): what changes for a project moving to Angular 19, 20, 21 or 22; there are no notes for earlier majors

## Playground

- [Live playground](https://hamidihamza.com/ajsf/): 71 example schemas, each rendered with any of the supported frameworks

## Optional

- [@ajsf/material README](https://github.com/hamzahamidi/ajsf/blob/main/projects/ajsf-material/README.md): Angular Material setup
- [@ajsf/primeng README](https://github.com/hamzahamidi/ajsf/blob/main/projects/ajsf-primeng/README.md): PrimeNG setup
- [@ajsf/bootstrap5 README](https://github.com/hamzahamidi/ajsf/blob/main/projects/ajsf-bootstrap5/README.md): Bootstrap 5 setup, including the bootstrap package and its stylesheet
- [Contributing](https://github.com/hamzahamidi/ajsf/blob/main/CONTRIBUTING.md): reporting issues, running the workspace and its tests, and commit conventions