bknd

⭐ Live Demo

bknd simplifies app development by providing a fully functional backend for database management, authentication, media and workflows. Being 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.

Size

The size on npm is misleading, as the bknd package includes the backend, the ui components as well as the whole backend bundled into the cli including static assets.

Motivation

Creating digital products always requires developing both the backend (the logic) and the frontend (the appearance). Building a backend from scratch demands deep knowledge in areas such as authentication and database management. Using a backend framework can speed up initial development, but it still requires ongoing effort to work within its constraints (e.g., "how to do X with Y?"), which can quickly slow you down. Choosing a backend system is a tough decision, as you might not be aware of its limitations until you encounter them.

The solution: A backend system that only assumes and implements primitive details, integrates into multiple environments, and adheres to industry standards.

Features

• ⚡ Instant backend with full REST API:
  • Data: Define, query, and control your data with ease.
  • Auth: Easily implement reliable authentication strategies.
  • Media: Effortlessly manage and serve all your media files.
  • Flows: Design and run workflows with seamless automation. (UI integration coming soon!)
• 🌐 Built on Web Standards for maximum compatibility
• 🏃‍♂️ Multiple run modes
  • standalone using the CLI
  • using a JavaScript runtime (Node, Bun, workerd)
  • using a React framework (Astro, Remix, Next.js)
• 📦 Official API and React SDK with type-safety
• ⚛️ React elements for auto-configured authentication and media components

Structure

The package is mainly split into 4 parts, each serving a specific purpose:

Import	Purpose
bknd bknd/adapter/*	Backend including APIs and adapters
bknd/ui	Admin UI components for react frameworks
bknd/client	TypeScript SDK and React hooks for the API endpoints
bknd/elements	React components for authentication and media

The backend (bknd)

Serve the backend as an API for any JS runtime or framework. The latter is especially handy, as it allows you to deploy your frontend and backend bundled together. Furthermore it allows adding additional logic in a way you're already familar with. Just add another route and you're good to go.

Here is an example of serving the API using node:

import { serve } from "bknd/adapter/node"
serve();

Integrated admin UI (bknd/ui)

The admin UI allows to manage your data including full configuration of your backend using a graphical user interface. Using vite, your admin route looks like this:

import { Admin } from "bknd/ui"
import "bknd/dist/styles.css";

export default function AdminPage() {
   return <Admin />
}

Using the REST API or TypeScript SDK (bknd/client)

If you're not using a JavaScript environment, you can still access any endpoint using the REST API:

curl -XGET <your-endpoint>/api/data/<entity>
{
  "data": [
    { "id": 1, ... },
    { "id": 2, ... }
  ],
  "meta": { /* ... */ }
}

In a JavaScript environment, you can use the TypeScript SDK with type-safety. The above example would look like this:

import { Api } from "bknd/client";

const api = new Api({ host: "<endpoint>" });
const { data } = await api.data.readMany("<entity>");

If you're using React, there are 2 hooks exposed (useApi, useEntity), as well as an swr wrapper around each (useApiQuery, useEntityQuery). The swr wrapped hooks automatically handled query invalidation:

import { useState } from "react";
import { useEntityQuery } from "bknd/client";

export default function App() {
   const { data } = useEntityQuery("todos");   
   return <ul>
      {data?.map(todo => (
         <li key={todo.id}>{todo.name}</li>
      ))}
   </ul>
}

React elements (bknd/elements)

You don't have to figure out API details to include media uploads to your app. For an user avatar upload, this is all you need:

import { Media } from "bknd/elements"
import "bknd/dist/main.css"

export function UserAvatar() {
   return <Media.Dropzone
     entity={{ name: "users", id: 1, field: "avatar" }}
     maxItems={1}
     overwrite
   />
}

The import path also exports components for login and registration forms which are automatically pointed to the bknd defaults.

🚀 Quick start

To quickly spin up an instance, run:

npx bknd run

Installation

npm install bknd