clark-orm

ClarkORM

If you like this project, please give us a star :star:

ClarkORM is a Typescript ORM built on top of Lucid ORM (AdonisJS V5).

Why

AdonisJS is a great framework and it has one of the best ORM. But it works only in its ecosystem. Using ClarkORM you can have all the benefits of Lucid, but in any project you want.

How it works

ClarkORM is built on top of Lucid ORM and Lucid ORM is built on top of knex. The idea of ClarkORM is let you manage your migrations and seeds with knex the way you already do. But when it comes to Models ClarkORM comes on scene.

Installation

npm install clark-orm
npm install reflect-metadata
npm install luxon

Usage

import { DateTime } from "luxon";
import { BaseModel, column } from "clark-orm/Orm";

export class CityModel extends BaseModel {
  public static table = "cities";

  @column({ isPrimary: true })
  public id!: number;

  @column()
  public name!: string;

  @column.dateTime({ autoCreate: true })
  public createdAt!: DateTime;

  @column.dateTime({ autoCreate: true, autoUpdate: true })
  public updatedAt!: DateTime;
}

Lucid has a lot of options, but what do you can do using ClarkORM? We offer some things that you can use like you would use with Lucid:

clark-orm/Orm
clark-orm/Database
clark-orm/Factory
clark-orm/Seeder
clark-orm/Event

You can learn more about the models here.

We use the variables contained in the knexfile because Lucid ORM is built on top of knex

Extra

To use ClarkORM you need to know at least a little about knex and Lucid

Do you like to learn with examples? We have one here