Build web admin interfaces and internal tools in modern Java -- modern Java is very nice! Without writing JavaScript.

This is a pure-Java toolkit for stateful, server-rendered live applications. No need for REST endpoints, dependencies on JavaScript frameworks like React, frontend build steps, managing frontend state, and most UI boilerplate.

Enable AI agents to understand your UI structure from within, out of the box.

Workflows == sentences

Prompt: "Open comments, go to page two, and select all items."

The AI agent natively understands your application's structure, navigates the UI, and queues up the actions. Keep the human in the loop for approval.

Why it's different

• Developer Productivity: Java developers build internal tools in plain Java -- no annotations and implicit control flows; components can be tested in isolation.
• Security & Supply Chain: Eliminate thousands of transitive npm dependencies. The toolkit aspires to be self-contained and distributed as source.
• AI: The Java HTML DSL is linear, component-based, and composable. That makes it easy for LLMs (like Claude or GPT) to generate valid DSL HTML and a component tree. At runtime, AI agents read and interact with the app using the defined metadata structure.

What does the code look like?

import rsp.component.View;
import rsp.component.definitions.InitialStateComponent;
import rsp.jetty.WebServer;

import static rsp.dsl.Html.*;

public final class HelloWorld {
   static void main(final String[] args) {
      final ComponentView<Integer> view = newState -> state ->
              html(
                      body(
                              h1("Current count: " + state),
                              button(on("click", _ -> newState.setState(state + 1)),
                                     text("Increment"))
                      )
              );

      final var server = new WebServer(8080, _ -> new InitialStateComponent<>(0, view));
      server.start();
      server.join();
   }
}

Getting started

1. Prerequisites

   • Java 25+ -- built with virtual threads, sealed interfaces and pattern matching
   • Maven 3.9+

2. Clone the repository

git clone https://github.com/vadimv/server-components.git
cd server-components

3. Build the project

mvn install

4. Run the included admin example

mvn exec:java -pl examples -Dexec.mainClass="rsp.app.posts.CrudApp"

Open http://localhost:8085, click Sign in, and explore the Posts/Comments admin app.

By default, CrudApp uses RegexAgentService, a deterministic regex-based agent stub included in the repository. It is meant for demos and local validation, so you can try the AI workflow without setting up Anthropic, Ollama, or any other LLM backend.

5. Try a few prompts

• open comments
• go to page 2
• open comments and go to page 2 and select all

6. Generate your own admin app

Once you've run the example, open your favorite AI coding assistant in the project root and paste a prompt like this:

Read examples/src/main/java/rsp/app/posts/CrudApp.java. Generate a similar realtime admin tool for managing Employees and Departments. Create mock services and a new EmployeeAdminApp.java using the same routing, composition, and AI-agent integration patterns.

7. Upgrade to a full LLM agent

When you're ready, run CrudApp with -Dai.agent=claude or -Dai.agent=ollama and connect your preferred model backend.

Auditable by design

This project aims to provide strong runtime supply-chain guarantees. The target architecture is zero third-party runtime dependencies.

Docs

• Core