NeonFlux

A Fluxer bot with a signed-in web dashboard.
Deliver messages, manage member access, and make reviewed server changes.

Important

NeonFlux is unreleased. Breaking changes and development data resets are expected.

Current capabilities

Area	What it does
Messages	Compose, preview, queue, and track dashboard messages without hiding uncertain delivery.
Reaction Roles	Publish managed role menus with independent or exclusive selection.
Autoroles	Assign selected permissionless roles to future human members.
Verification	Gate access through a managed reaction or a hosted image CAPTCHA.
Server Blueprint	Capture, compare, approve, apply, verify, and recover complete server layouts.
Activity and settings	View growth and audit activity, then manage the bot command prefix.

Run NeonFlux locally

Use Node 24.19.0 and pnpm 11.

cd projects
pnpm install
cp .env.example .env
pnpm setup:dev -- --write
pnpm dev

Use Copy-Item .env.example .env instead of cp in PowerShell.

The setup command creates missing local signing and encryption material without printing it. Add your own Fluxer application ID, OAuth client secret, and bot token to projects/.env.

Read Local setup before connecting a development deployment.

Documentation

Guide	Audience
Local setup	Contributors starting the full development stack
Contributing	Contributors validating and handing off changes
How NeonFlux works	Maintainers tracing authority and data flow
Messages	Maintainers working on delivery and recovery
Server Blueprint	Maintainers working on planned server changes
Convex	Operators configuring durable storage and authentication
Docker	Operators running production-style services
Live Fluxer integration	Maintainers operating the guarded provider workflow

The website also serves task-focused documentation for server administrators.

Repository layout

Application code lives in projects.

Path	Responsibility
projects/apps/web	Public pages, OAuth, sessions, authorization, and dashboard UI
projects/apps/bot	Fluxer gateway, private live reads, schedulers, and workers
projects/convex	Durable data, transactions, queues, leases, and live updates
projects/packages/db	Typed application access to Convex
projects/packages/fluxer	Fluxer clients and provider translation
projects/packages/blueprint	Server Blueprint validation, planning, and safety rules
projects/packages/captcha	CAPTCHA generation and evaluation
projects/packages/messaging	Outgoing message rules
projects/packages/member-access	Member-access rules
projects/packages/reaction-roles	Reaction Role contracts and policy
projects/packages/core	Shared policy and implemented bot command metadata
projects/packages/config	Typed application configuration

License

NeonFlux is available under the Apache License 2.0.