🔥 Backan - Core

All in one web API builder.

BACKAN Create endpoints with type validations and OpenApi documentation, safely and quickly.

This package contains BACKAN Core library

Table of Contents

• 🔑 Installation
  • Install only core
• Setup
• Create App instace
• Create Route
• Add Endpoints
• What is BACKAN?
• Project intention
• Contains
• Todo
• What is backan built with?
• 🏁 Get started with Backan
• 🗄️ Get started with Backan server
• 📦 Build your project

Start building your restAPI app now 🌈.

🔑 Installation

npm install backan

pnpm add backan

yarn add backan

bun add backan

Install only core

npm install @backan/core

pnpm add @backan/core

yarn add @backan/core

bun add backan

Setup

You can automatically create a backan template with:

npm create backan

pnpm create backan

yarn create backan

bun create backan

Read more

Create App instace

Read more

Create Route

Read more

Add Endpoints

• GET
• POST
• STREAM

What is BACKAN?

BACKAN is a library designed to build REST API applications quickly and easily.

[!IMPORTANT] Currently in phase Beta The library can be used perfectly in production, but could undergo changes and new features until version 1. To avoid ongoing maintenance issues, we recommend installing a fixed version (without ^) in your project.

Project intention

Our project is not intended to be a substitute for any web framework. Our library aims to cover a specific use case, that of building APIs, simplifying this process as much as possible and creating APIs in a robust way.

The creation of this project is also due to the need of our collective to create APIs with good documentation and in a simple way, an example of this is the Api section of bepp (a web extension packager).

Contains

• ✅ Simple data validation, so that your endpoints are as secure as possible and reduce repetitive code (boilerplate).
• ✅ Built-in and almost automatic OpenAPI documentation, improving the visibility of our API without the need to import other projects.

In addition, BACKAN also provides:

• A backan project creator with templates of greater and lesser complexity. Read more
• Configuration to create your Node server, perfect for running your application without having to configure anything. Read more
• Tool to build the binary of your application, ideal for running the app without the need for a Node.js environment. Read more

[!note] The documentation is under construction. Soon, we will write all the points it contains

Todo

• 💡 Typing for make your frontend projects more easy.

Read more

What is backan built with?

Our library is built under the hono framework, which is why you will see references to it in our documentation and our code. BACKAN is an implementation that aims to simplify the construction of apirest for specific use cases.

You want to build an apirest quickly and safely and without thinking about third-party implementations, well here we propose our alternative.

🏁 Get started with Backan

Start building your restAPI app now 🌈.

Read more

🗄️ Get started with Backan server

Read more

📦 Build your project

The backan builder library allows you to build multiple things. Among others:

• Executables / binaries: Create binaries of your project for all systems and architectures with zero config.
• Client library: Create a client to facilitate the implementation of the API in a frontend or other service.
• JSON schema file: Export the OpenAPI schema to a JSON file.
• TypeScript definitions file: Export OpenAPI schema to a d.ts file.
• Markdown documentation: Build your application documentation in a Markdown file.

Read more

More from Backan

• Documentation
  • 📚 Library
  • 🏁 Create (setup)
  • 🗄️ Server
  • 📦 Builder
• Installation

👨‍💻 Development

BACKAN is an open-source project and its development is open to anyone who wants to participate.

☕ Donate

Help us to develop more interesting things.

📜 License

This software is licensed with GPL-3.0.

🐦 About us

PigeonPosse is a ✨ code development collective ✨ focused on creating practical and interesting tools that help developers and users enjoy a more agile and comfortable experience. Our projects cover various programming sectors and we do not have a thematic limitation in terms of projects.

Collaborators

| | Name | Role | GitHub | | ---------------------------------------------------------------------------------- | ----------- | ------------ | ---------------------------------------------- | | | Angelo | Author & Development | @Angelo | | | PigeonPosse | Collective | @PigeonPosse |