Home

Awesome

<p align="center"> <img src="https://user-images.githubusercontent.com/7868838/103797784-32337580-5049-11eb-8917-3fcf4487644c.png"/> </p> <p align="center"> <img alt="GitHub branch checks state" src="https://img.shields.io/github/checks-status/kuzzleio/kuzzle/master"> <img alt="Sonarcloud" src="https://sonarcloud.io/api/project_badges/measure?project=kuzzleio_kuzzle&metric=alert_status&branch=master"> <a href="https://lgtm.com/projects/g/kuzzleio/kuzzle/context:javascript"> <img src="https://img.shields.io/lgtm/grade/javascript/g/kuzzleio/kuzzle.svg?logo=lgtm&logoWidth=18" /> </a> <a href="https://lgtm.com/projects/g/kuzzleio/kuzzle/alerts"> <img src="https://img.shields.io/lgtm/alerts/g/kuzzleio/kuzzle.svg?logo=lgtm&logoWidth=18" /> </a> <a href="https://github.com/kuzzleio/kuzzle/blob/master/LICENSE"> <img alt="undefined" src="https://img.shields.io/github/license/kuzzleio/kuzzle.svg?style=flat"> </a> </p>

Why Kuzzle ?

Kuzzle is a generic backend offering the basic building blocks common to every application.

Rather than developing the same standard features over and over again each time you create a new application, Kuzzle proposes them off the shelf, allowing you to focus on building high-level, high-value business functionalities.

Kuzzle enables you to build modern web applications and complex IoT networks in no time.

Learn how Kuzzle will accelerate your developments :point_right: https://docs.kuzzle.io/core/2/guides/introduction/what-is-kuzzle/

Kuzzle in production

Kuzzle is production-proof, and can be deployed anywhere.

With Kuzzle, it is possible to deploy applications that can serve tens of thousands of users with very good performances.

Check out our support plans.

Run Kuzzle

The easiest way to start a Kuzzle application is to use Kourou:

kourou app:scaffold playground

 🚀 Kourou - Scaffolds a new Kuzzle application

generic
  ✔ Checking destination
  ✔ Prepare temporary folder
  ✔ Cloning template repository
  ✔ Copying template files
  ✔ Cleaning up

 [✔] Scaffolding complete!
 [✔] Use cd playground && docker compose up -d to start your Kuzzle stack.

Then you need to run Kuzzle services, Elasticsearch and Redis: kourou app:start-services

Finally you can run your application inside Docker with npm run docker:dev

Kuzzle is now listening for requests on the port 7512!

Use the framework

Your first Kuzzle application is inside the app.ts file.

For example, you can add a new API Controller:

import { Backend } from 'kuzzle';

const app = new Backend('playground');

app.controller.register('greeting', {
  actions: {
    sayHello: {
      handler: async request => `Hello, ${request.input.args.name}`
    }
  }
});

app.start()
  .then(() => {
    app.log.info('Application started');
  })
  .catch(console.error);

Now try to call your new API action by:

Learn how to Write an Application.

Useful links

Get trained by the creators of Kuzzle :zap:

Train yourself and your teams to use Kuzzle to maximize its potential and accelerate the development of your projects. Our teams will be able to meet your needs in terms of expertise and multi-technology support for IoT, mobile/web, backend/frontend, devops. :point_right: Get a quote

Contributing to Kuzzle

You're welcome to contribute to Kuzzle! Feel free to report issues, ask for features or even make pull requests!

Check our contributing documentation to know about our coding and pull requests rules

Join our community

License

Kuzzle is published under Apache 2 License.