A Fluxer bot with a secure web dashboard.
Send messages, inspect server activity, and safely plan or apply complete server layouts.
Important
NeonFlux is an unreleased work in progress. Breaking changes and development database resets are expected.
| Feature | In plain language |
|---|---|
| Messages | Build and preview a message, choose a channel, send it safely, and see whether delivery succeeded, failed, or is uncertain. |
| Server Blueprint | Capture or import a server layout, review the exact changes, approve them, apply them through the bot, and verify the result. |
NeonFlux also includes server activity, command-prefix settings, audit events, message templates, backups, drift checks, and recovery tools.
Use Node 24.18.0 and pnpm 11.
cd Projects
pnpm install
cp .env.example .env
pnpm setup:dev -- --write
pnpm devOn PowerShell, use Copy-Item .env.example .env instead of cp.
The setup command creates local signing and encryption keys without printing them. You must still add your own Fluxer application ID, OAuth client secret, and bot token to Projects/.env.
For the complete setup, read Local setup.
| Guide | Use it when you want to… |
|---|---|
| Local setup | install dependencies, create local secrets, configure Convex, and start the apps |
| Contributing | know which checks must pass and which extra checks need Docker or Chromium |
| Messages | understand message sending, retries, uncertain delivery, and mention safety |
| Server Blueprint | understand plans, safety checks, deployment modes, runs, and recovery |
| How NeonFlux works | understand the browser, web app, Convex, bot, and Fluxer boundaries |
| Convex | configure authentication, deployments, retention, code generation, or a guarded reset |
| Docker | build and run the production containers |
Application code lives in Projects.
| Path | Owns |
|---|---|
apps/web |
public pages, OAuth, sessions, and the signed-in dashboard |
apps/bot |
Fluxer connection, live reads, and queued provider changes |
convex |
durable data, transactions, queues, and live updates |
packages/blueprint |
Server Blueprint validation, planning, and safety rules |
packages/messaging |
outgoing-message validation and delivery rules |
packages/fluxer |
translation between NeonFlux data and Fluxer APIs |
packages/db |
typed access to Convex |
NeonFlux is available under the MIT License.