v1.7.28

A lightweight Java framework for modern apps

Build efficient, scalable applications with a unified CLI and Web architecture. Zero boilerplate, maximum performance.

High Performance

Engineered for speed with minimal overhead. Handles high-throughput workloads with ease.

86,000+
Requests / Second

Simple & Elegant

No main() method required. Just pure logic.

JAVA
package com.example;

import org.tinystruct.AbstractApplication;
import org.tinystruct.data.component.Builder;
import org.tinystruct.data.component.Builders;
import org.tinystruct.system.annotation.Action;

public class HelloApp extends AbstractApplication {

    @Action("hello")
    public String hello() {
        return "Hello, World!";
    }

    @Action("user")
    public Builder getUser(String id) {
    //  userService.findById(id);
        return new Builder();
    }

    @Action("users")
    public Builders getUsers() {
    //  userService.findAll();
        return new Builders();
    }

    @Override
    public void init() {
        this.setTemplateRequired(false);
    }

    @Override
    public String version() {
        return "1.0";
    }
}
$ bin/dispatcher --version
_/ ' _ _/ _ _ _/
/ / /) (/ _) / / (/ ( / 1.7.28
/
$ bin/dispatcher --help
Usage: bin/dispatcher COMMAND [OPTIONS]
Commands:
download Download a resource from other servers
exec To execute native command(s)
generate POJO object generator
install Install a package
open Start a default browser to open the specific URL
say Output words
set Set system property
sql-execute Executes the given SQL statement, which may be an INSERT, UPDATE, DELETE, or DDL statement
sql-query Executes the given SQL statement, which returns a single ResultSet object
update Update for the latest version
Options:
--allow-remote-access Allow to be accessed remotely
--help Help command
--host Host name / IP
--import Import application
--logo Print logo
--settings Print settings
--version Print version
Run 'bin/dispatcher COMMAND --help' for more information on a command.

Unified Architecture

Write your logic once and expose it as both a Command Line Interface and a Web API instantly.

Multiple Servers

HttpServer is the built-in default, but also supports Tomcat, Netty HTTP server, and Undertow.

AI Ready (MCP)

Native integration with Model Context Protocol for building next-gen AI applications.

Real-time SSE

Push updates to clients instantly with built-in Server-Sent Events support.

Lightweight

Tiny footprint with minimal external dependencies. Perfect for microservices.

Zero Configuration

Convention over configuration principles. Start coding immediately without XML hell.