Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/kitesjs/kites
Template-based Web Application Framework
https://github.com/kitesjs/kites
autodiscover extensions-manager javascript-framework kites kites-templates kitesjs lightweight-framework nodejs-framework template-based typescript-framework web-application-framework websockets
Last synced: about 1 month ago
JSON representation
Template-based Web Application Framework
- Host: GitHub
- URL: https://github.com/kitesjs/kites
- Owner: kitesjs
- License: mit
- Created: 2017-07-30T10:42:38.000Z (about 7 years ago)
- Default Branch: master
- Last Pushed: 2022-12-10T22:43:42.000Z (over 1 year ago)
- Last Synced: 2024-04-14T10:53:49.140Z (5 months ago)
- Topics: autodiscover, extensions-manager, javascript-framework, kites, kites-templates, kitesjs, lightweight-framework, nodejs-framework, template-based, typescript-framework, web-application-framework, websockets
- Language: TypeScript
- Homepage: https://kitesjs.github.io/kites
- Size: 1.61 MB
- Stars: 54
- Watchers: 2
- Forks: 6
- Open Issues: 22
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# kites
Template-based Web Application Framework
[](https://gitter.im/nodevn/kites)
[](https://www.npmjs.com/package/@kites/core)
[](https://www.npmjs.com/package/@kites/core)
[](https://travis-ci.org/kitesjs/kites)
**Kites** is a framework providing `dynamic applications` assembling and `Template-based` extracting. Namely it contains a lot of templates and extensions to help building a new application quickly.
Features
=======
* [x] Extension as a feature
* [x] Autodiscover extensions
* [x] Rich decorators system
* [x] Event-driven programming
* [ ] Reactive programming
* [ ] Storage mutiple providers
* [ ] Micro frontends development
Installation
============
```bash
# install kites cli
$ npm install -g @kites/cli
# init a project
kites init my-project
# move to project workspace
cd my-project
# install dependencies
npm install
# start development
npm start
```
To change environment use cmd `set NODE_ENV=development` or use options your IDE provides. If you don't specify node environment kites assumes `development` as default.
Example
=======
The application below simply prints out a greeting: **Hello World!**
`TypeScript` version:
```ts
import {engine} from '@kites/core';
async function bootstrap() {
const app = await engine().init();
app.logger.info('Hello World!');
}
bootstrap();
```
`JavaScript` version:
```js
const kites = require('@kites/core');
kites.engine().init().then((app) => {
app.logger.info('Hello World!');
});
```
Extensions
==========
**Kites** is an eco-system and has many modules which can be assembled into a larger application. You are welcome to write your own extension or even publish it to the community.
Auto discovery
==============
Kites has an option to allow the application auto discover extensions in the directory tree. This means `kites` will searches for files `kites.config.js` which describes the extensions and applies all the extensions that are found automatically.
This is fundamental principle for allowing extensions as plugins to be automatically plugged into the system. The application completed with minimalist lines of code, but very powerful!
```ts
import {engine} from '@kites/core';
async function bootstrap() {
// let kites autodiscover the extensions
const app = await engine({ discover: true }).init();
app.logger.info('A new kites started!');
}
bootstrap();
```
Kites extensions auto discovery might slows down the startup and can be explicitly override by using `use` function. The following code has a slightly complicated configuration for each extension which we want to use.
```ts
import {engine} from '@kites/core';
import express from '@kites/express';
async function bootstrap() {
const app = await engine({
discover: false,
})
.use(express())
.on('express:config', app => {
app.get('/hi', (req, res) => res.send('hello!'));
})
.init();
app.logger.info(`Let's browse http://localhost:3000/hi`);
}
// let kites fly!
bootstrap();
```
Templates
=========
Here is the list of **built-in templates** and their implementation status:
* [x] `starter`: Kites Project Starter with Typescript (**default**)
* [x] `docsify`: Template webserver for documentation site generator
* [x] `chatbot`: Template for generating an AI Chatbot
More templates, checkout [issue #1](https://github.com/vunb/kites/issues/1).
Documentation
=============
* Checkout: [kites.nodejs.vn](https://kites.nodejs.vn)
# License
MIT License
Copyright (c) 2018 Nhữ Bảo Vũ
