cruky 0.12.0

cruky is server-side library to create API with modern and fast performance.

Cruky

Cruky is a server-side library for the dart ecosystem to help you create your API as fast as possible. Cruky team want to make server-side apps with modern style and fast high performance.

The main reason why Cruky was built, because all libraries are focused on the Flutter ecosystem and not on dart language and this makes the library have fewer futures than other frameworks or libraries like (Django, FastAPI, ROR, ..etc) So cruky team decided that we will make a new library that focuses on Dart and get the maximum performance using dart mirrors and code generators together to get the best usage of the dart.

If you have any idea tell me in discussion section on github Submit new idea

Inspired by server-side frameworks like (Django, Flask, FastAPI)

!!! danger This is an early release of Cruky. there may be minor changes in future updates. A few features are still missing that will be part of the 1.0 release.

---

Pub: https://pub.dev/packages/cruky

Documentation: https://seifalmotaz.github.io/cruky/

Source Code: https://github.com/seifalmotaz/cruky

Issues: https://github.com/seifalmotaz/cruky/issues

---

Requirements

• Install Dart from Dart.dev
• run dart pub global activate cruky to install cruky executable
• create project by running cruky create appName

Note: if you run cruky and get bash: cruky: command not found error you can do this:

• try to run cruky.bat create appName
• if it did not work add C:\Users\{{Your name}}\AppData\Local\Pub\Cache\bin to your enviroment variables

First lines

First we must define our main app or the server entry point that have all the routes we use in the app as Cruky recommend to name it MyApp

import 'package:cruky/cruky.dart';

class MyApp extends ServerApp {
  @override
  List get routes => [];

  @override
  List get pipeline => [];
}

We can define two main things the routes getter and pipeline getter:

• routes used to add the route methods for the app
• middlewares used to add global middleware for the routes inside this app

Second we can add some routes to the main app, we will create a route that response with json and contains a massege:

// rest of code

@Route.get('/')
Json getData(Request req) {
  return Json({'msg': "Hello world"});
  /// You can use text response too like this Text("Hello world")
}

We define an annotation first that contains the path then we add a method that handles the request and have a argument called req this argument has type Request that will help you get the request data easily like the (json, form, multipart/form)

Now we must add this method to the main app inside the routes getter:

// rest of code

class MyApp extends ServerApp {
  @override
  List get routes => [
      getData,
  ];

  @override
  List get pipeline => [];
}

// rest of code

Last thing add the main function that will run the app:

void main() => runApp(MyApp());
// rest of code

Now run the app with command dart pub run cruky serve or you can run dart run --enable-vm-service --disable-service-auth-codes bin/main.dart both are the same. this will run the app in debug mode with hot reload.