mirror of
https://github.com/shishantbiswas/bknd.git
synced 2026-03-16 20:37:21 +00:00
53 lines
2.3 KiB
Markdown
53 lines
2.3 KiB
Markdown
|
|
|
|
bknd simplifies app development by providing fully functional backend for data management,
|
|
authentication, workflows and media. Since it's lightweight and built on Web Standards, it can
|
|
be deployed nearly anywhere, including running inside your framework of choice. No more
|
|
deploying multiple separate services!
|
|
|
|
**For documentation and examples, please visit https://docs.bknd.io.**
|
|
|
|
> [!WARNING]
|
|
> Please keep in mind that **bknd** is still under active development
|
|
> and therefore full backward compatibility is not guaranteed before reaching v1.0.0.
|
|
|
|
## ✨ Features
|
|
**📊 Data**: Define, query, and control your data with ease.
|
|
- Define entities with fields and relationships, synced directly to your database.
|
|
- Supported field types: `primary`, `text`, `number`, `date`, `boolean`, `enum`, `json`, `jsonschema`.
|
|
- Relationship types: `one-to-one`, `many-to-one`, `many-to-many`, and `polymorphic`.
|
|
- Advanced querying with the **Repository**: filtering, sorting, pagination, and relational data handling.
|
|
- Seamlessly manage data with mutators and a robust event system.
|
|
- Extend database functionality with batching, introspection, and support for multiple SQL dialects.
|
|
|
|
**🔐 Auth**: Easily implement reliable authentication strategies.
|
|
- Built-in `user` entity with customizable fields.
|
|
- Supports multiple authentication strategies:
|
|
- Email/password (with hashed storage).
|
|
- OAuth/OIDC (Google, GitHub, and more).
|
|
- Secure JWT generation and session management.
|
|
|
|
**🖼️ Media**: Effortlessly manage and serve all your media files.
|
|
- Upload files with ease.
|
|
- Adapter-based support for S3, S3-compatible storage (e.g., R2, Tigris), and Cloudinary.
|
|
|
|
**🔄 Flows** (UI integration coming soon!): Design and run workflows with seamless automation.
|
|
- Create and run workflows with trigger-based automation:
|
|
- Manual triggers or events from data, auth, media, or server actions.
|
|
- HTTP triggers for external integrations.
|
|
- Define tasks in sequence, parallel, or loops, with conditional execution.
|
|
- Use reusable sub-workflows to organize complex processes.
|
|
- Leverage OpenAPI specifications for API-based tasks.
|
|
|
|
|
|
## 🚀 Quick start
|
|
To quickly spin up an instance, run:
|
|
```bash
|
|
npx bknd run
|
|
```
|
|
|
|
### Installation
|
|
```bash
|
|
npm install bknd
|
|
```
|