tinystruct
A lightweight, modular Java application framework for web and CLI development, designed for AI integration and plugin-based architecture. Enabling developers to create robust solutions with ease for building efficient and scalable applications.
Safety scan
A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.
Check it deeper on your machine
It has changed since its scan on 11 Nov 2026.
As a Claude Code plugin, install it and then ask Claude Code:
/plugin marketplace add keithmackay/mackayi/plugin install scanskillsafety@mackayiDo a deep scan of https://github.com/tinystruct/tinystruct with scanskillsafety
Or from a terminal, clone it and run it:
git clone https://github.com/keithmackay/scanskillsafety-skill ~/.claude/skills/scanskillsafetynode ~/.claude/skills/scanskillsafety/cli.cjs --deep 'https://github.com/tinystruct/tinystruct'
It checks the exact commit: every file, its packages against OSV (api.osv.dev), how it compares with this page's scan (findsafeskills.com receives the repository's address), and, if you agree, Claude reading every file with your own Claude subscription. It never runs the code.
Badge for your README
Markdown
[](/listings/tinystruct--tinystruct)HTML
<a href="/listings/tinystruct--tinystruct"><img src="/api/listings/tinystruct--tinystruct/badge.svg" alt="findsafeskills safety rating" /></a>Install
Install instructions from the README
As written by the repo's author. findsafeskills has not verified these steps.
* Add the dependency into your pom.xml.
<dependency> <groupId>org.tinystruct</groupId> <artifactId>tinystruct</artifactId> <version>1.7.35</version> </dependency>
To use the framework as a standalone command-line tool, build the optional jar that bundles all dependencies (about 50 MB, not part of the release):
./mvnw package -Pstandalone # Windows: mvnw.cmd package -Pstandalone java -jar target/tinystruct-1.7.35-jar-with-dependencies.jar --help
* Extend the AbstractApplication in Java:
package tinystruct.examples;
import org.tinystruct.AbstractApplication;
import org.tinystruct.ApplicationException;
import org.tinystruct.system.annotation.Action;
public class example extends AbstractApplication {
@Override
public void init() {
// TODO Auto-generated method stub
}
@Override
public String version() {
return "1.0";
}
@Action("praise")
public String praise() {
return "Praise the Lord!";
}
@Action("say")
public String say() throws ApplicationException {
if (null != getContext().getAttribute("--words"))
return getContext().getAttribute("--words").toString();
throw new ApplicationException("Could not find the parameter <i>words</i>.");
}
@Action("say")
public String say(String words) {
return words;
}
@Action(value = "hello", mode = Mode.HTTP_GET)
public String helloGet() {
return "GET";
}
@Action(value = "hello", mode = Mode.HTTP_POST)
public String helloPost() {
return "POST";
}
}
Smalltalk: <a href="https://github.com/tinystruct/smalltalk">https://github.com/tinystruct/smalltalk</a>
What was scanned
The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.
README.md · README · 234 lines
View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)
This file has changed since it was scanned, so this is not exactly the text that was scanned, and no line is marked. The findings are listed with the safety scan above.
- `"How many are your works, O LORD ! In wisdom you made them all; the earth is full of your creatures."`
- ***Psalms 104:24***
- <img width="1774" height="887" alt="Image" src="https://github.com/user-attachments/assets/0e2c7a76-48f8-4075-9805-a332ca928dc8" />
- Language: [English](README.md) | [Português (Brasil)](docs/README.pt-BR.md) | [简体中文](docs/README.zh-CN.md) | [繁體中文](docs/README.zh-TW.md) | [日本語](docs/README.ja.md) | [한국어](docs/README.ko.md) | [Türkçe](docs/README.tr.md) | [Русский](docs/README.ru.md) | [Tiếng Việt](docs/README.vi.md) | [ไทย](docs/README.th.md) | [Deutsch](docs/README.de.md) | [Español](docs/README.es.md)
- The tinystruct framework
- --
- A simple framework for Java development. Simple thinking, Better design, Easy to be used with better performance!
- [](https://mvnrepository.com/artifact/org.tinystruct/tinystruct)
- [](https://central.sonatype.com/artifact/org.tinystruct/tinystruct)
- [](https://github.com/tinystruct/tinystruct/actions/workflows/build.yml)
- [](https://github.com/tinystruct/tinystruct/actions/workflows/codeql.yml)
- [](LICENSE)
- 
- [](https://github.com/tinystruct/tinystruct/stargazers)
- [](https://github.com/tinystruct/tinystruct/commits/master)
- ## Prerequisites
- - Java Development Kit (JDK) 17 or higher
- - Maven (for dependency management)
- - A text editor or IDE (IntelliJ IDEA, Eclipse, VS Code, etc.)
- Getting Started with tinystruct archetype
- --
- You can follow this archetype to create a tinystruct-based project quickly: https://github.com/tinystruct/tinystruct-archetype
- Or create a project with a single command (Linux/macOS, requires JDK 17+ and Maven; choose basic, web, mcp, workflow or agent):
- ```bash
- curl -fsSL https://tinystruct.org/create | sh
- ```
- On Windows (requires Git for Windows or WSL), run this in PowerShell:
- ```powershell
- irm https://tinystruct.org/create.ps1 | iex
- ```
- Installation and Getting Started Manually
- --
- * Add the dependency into your pom.xml.
- ```xml
- <dependency>
- <groupId>org.tinystruct</groupId>
- <artifactId>tinystruct</artifactId>
- <version>1.7.38</version>
- </dependency>
- ```
- To use the framework as a standalone command-line tool, build the optional jar that bundles all dependencies (about 50 MB, not part of the release):
- ```bash
- ./mvnw package -Pstandalone # Windows: mvnw.cmd package -Pstandalone
- java -jar target/tinystruct-1.7.38-jar-with-dependencies.jar --help
- ```
- * Extend the AbstractApplication in Java:
- ```java
- package tinystruct.examples;
- import org.tinystruct.AbstractApplication;
- import org.tinystruct.ApplicationException;
- import org.tinystruct.system.annotation.Action;
- public class example extends AbstractApplication {
- @Override
- public void init() {
- // TODO Auto-generated method stub
- }
- @Override
- public String version() {
- return "1.0";
- }
- @Action("praise")
- public String praise() {
- return "Praise the Lord!";
- }
- @Action("say")
- public String say() throws ApplicationException {
- if (null != getContext().getAttribute("--words"))
- return getContext().getAttribute("--words").toString();
- throw new ApplicationException("Could not find the parameter <i>words</i>.");
- }
- @Action("say")
- public String say(String words) {
- return words;
- }
- @Action(value = "hello", mode = Mode.HTTP_GET)
- public String helloGet() {
- return "GET";
- }
- @Action(value = "hello", mode = Mode.HTTP_POST)
- public String helloPost() {
- return "POST";
- }
- }
- ```
- Smalltalk: <a href="https://github.com/tinystruct/smalltalk">https://github.com/tinystruct/smalltalk</a>
- Execute in CLI mode
- --
- ```tcsh
- $ bin/dispatcher --version
- _/ ' _ _/ _ _ _/
- / / /) (/ _) / / (/ ( / 1.7.38
- /
- ```
- ```tcsh
- $ bin/dispatcher --help
- Usage: bin/dispatcher COMMAND [OPTIONS]
- A command line tool for tinystruct framework
- Commands:
- download Download a resource from other servers
- exec To execute native command(s)
- generate POJO object generator
- install Install a package
- maven-wrapper Extract Maven Wrapper
- 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 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.
- ```
- ```tcsh
- $ bin/dispatcher say/"Praise the Lord"
- Praise the Lord
- ```
- ```tcsh
- $ bin/dispatcher say --words Hello --import tinystruct.examples.example
- Hello
- ```
- Run it in a http server
- --
- ```tcsh
- # bin/dispatcher start --import org.tinystruct.system.HttpServer
- ```
- You can access the below URLs:
- * <a href="http://localhost:8080/?q=say/Praise%20to%20the%20Lord!">http://localhost:8080/?q=say/Praise%20to%20the%20Lord! </a>
- * <a href="http://localhost:8080/?q=praise">http://localhost:8080/?q=praise</a>
- Performance Test
- --
- ```tcsh
- $ wrk -t12 -c400 -d30s "http://127.0.0.1:8080/?q=say/Praise the Lord!"
- Running 30s test @ http://127.0.0.1:8080/?q=say/Praise the Lord!
- 12 threads and 400 connections
- Thread Stats Avg Stdev Max +/- Stdev
- Latency 17.44ms 33.42ms 377.73ms 88.98%
- Req/Sec 7.27k 1.66k 13.55k 69.94%
- 2604473 requests in 30.02s, 524.09MB read
- Requests/sec: 86753.98
- Transfer/sec: 17.46MB
- ```
- Handling over **86,000** requests per second with low average latency (~17.44ms), indicating the endpoint is highly efficient under heavy load. this shows the raw power and efficiency of the **tinystruct framework**. But it's not just about the performance numbers. It's about the **philosophy** behind it.
- ### What makes tinystruct framework modern?
- 1. **No `main()` method required**
- Applications can be started directly using CLI commands like `bin/dispatcher`, with no boilerplate code needed. This removes unnecessary ceremony from the development lifecycle.
- 2. **Unified design for CLI and Web**
- Unlike Spring Boot which is primarily web-centric, **tinystruct** treats CLI and Web as equal citizens. This makes it perfect for AI tasks, script automation, and hybrid applications — all from the same codebase.
- 3. **Built-in lightweight HTTP server**
- Whether it’s Netty or Tomcat, tinystruct integrates the server lifecycle inside the framework. There's no need for separate containers or complicated configuration files. Just import what you need and run.
- 4. **Minimal configuration philosophy**
- Configuration is minimized to the essentials. You don't need to wire up hundreds of beans, and there's no excessive XML or YAML involved. This improves developer productivity and reduces bugs.
- 5. **Annotation-based routing**
- The framework provides a clean and intuitive routing mechanism using `@Action`, eliminating the need for overly complex controller hierarchies.
- 6. **Performance-first architecture**
- There’s almost zero overhead. No reflection-based bean scanning, no auto-wiring maze, no unnecessary interceptors unless explicitly enabled. This translates into faster response times and smaller memory footprint.
- 7. **Developer empowerment without complexity**
- With tinystruct, developers are free to focus on **real business logic** rather than fighting with framework mechanics. It's designed to be **transparent**, **predictable**, and **extensible** — all without sacrificing control or performance.
- ---
- Architecture
- --
- 
- License
- --
- Licensed under the Apache License, Version 2.0 (the "License");
- you may not use this file except in compliance with the License.
- You may obtain a copy of the License at
- http://www.apache.org/licenses/LICENSE-2.0
- Unless required by applicable law or agreed to in writing, software
- distributed under the License is distributed on an "AS IS" BASIS,
- WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
- See the License for the specific language governing permissions and
- limitations under the License.
Ratings and comments
Sign in to rate this skill.
Sign inFree to use. If it’s helped, pass it on.