Real-time config for Java apps β change values in your browser, see them instantly in running code. No restart. No redeploy.
Create a free account at kiponos.io (TeamPro plan, no credit card). Complete the onboarding wizard: app name, release, environment, and first config items.
git clone https://github.com/kiponos-io/kiponos-io.git
cd kiponos-io/golden/javaOpen build.gradle and replace the three placeholders in the JavaExec block with values from your account Connect screen:
REPLACE_WITH_KIPONOS_ID_FROM_ACCOUNTREPLACE_WITH_KIPONOS_ACCESS_FROM_ACCOUNT- Profile defaults to
['my-app']['v1.0.0']['dev']['base']β change if yours differs
./gradlew runYou should see springBootStarterURL: https://start.spring.io and SDK logs showing SDK Handshake Authenticated.
Full walkthrough: docs/GETTING-STARTED.md
- Keep the app running (or run again).
- In your Kiponos.io dashboard, change the
startervalue underuseful-urls β Development β Java β Frameworks-and-Libraries β SpringBoot. - Run
./gradlew runagain β the printed URL updates. No code change. No restart.
That is the Kiponos moment.
| Path | How |
|---|---|
| AI agent | ./skills/install.sh then ask: "Integrate Kiponos SDK using skills/kiponos/SKILL.md" |
| Manual | Follow docs/GETTING-STARTED.md integration section |
| Agent contract | Read AGENTS.md |
Kiponos is a real-time config hub. Your application connects via the Java SDK over a permanent WebSocket. Any change you make in the web dashboard is pushed instantly to every connected SDK β in memory, at runtime.
Kiponos kiponos = Kiponos.createForCurrentTeam();
String url = kiponos.path("DB", "PostgreSql").get("host");
int port = kiponos.path("DB", "PostgreSql").getInt("port");
kiponos.disconnect(); // on shutdownSDK: Maven Central io.kiponos:sdk-boot-3
| Path | What |
|---|---|
golden/java/ |
Minimal runnable Gradle smoke test |
skills/kiponos/ |
Agent skill (Grok, Cursor, Claude, Copilot) |
AGENTS.md |
Machine-readable integration contract |
docs/GETTING-STARTED.md |
Step-by-step human onboarding |
examples/comm-panel/ |
Swing demo β live window position/title from config |
examples/CATALOG.md |
Public examples catalog (runnable SDK scenarios) |
Releases: GitHub Releases β downloadable golden-java.zip
- Public sandbox β read-only tokens in golden so you can
./gradlew runbefore signup (details) - Community config tree β shared live values developers worldwide can read
- Config locks β team admins lock folders, keys, and values (UI + server ready; metadata persistence in progress)
- Kiponos local agent β MCP + skill installer for one-click integration
Questions? Open a Discussion or an issue.
Join Us β free TeamPro at kiponos.io
npm install @kiponos/react
npm install @kiponos/angular| Package | npm | Runnable example |
|---|---|---|
@kiponos/react |
npm | examples/node/react-status-wall |
@kiponos/angular |
npm | examples/node/angular-status-wall |
Source trees: sdks/kiponos-react-sdk, sdks/kiponos-angular-sdk.