Flux: easily manage your forms
Flux is a high-performance, single-binary application designed to handle secure, dynamic user input for static websites.
If you use tools like Hugo, Jekyll or 11ty, you know the pain of handling forms. You are often forced to choose between expensive SaaS subscriptions or fragile serverless functions.
Flux solves this by running as a private backend on your own VPS. It handles validation, spam protection, and notifications with a simple configuration.
Getting Started
Start here to get your instance up and running in minutes.
- 01 Installation: Download the latest binary for Linux, macOS, or Windows, install it with Golang or build it from source.
- 02 Configuration: Set up your environment variables and understand the "Sealed state" security model that enforces encryption on every sensitive information.
- 03 Using the TUI: Flux uses a unique Text User Interface accessed via SSH. No web dashboards to hack—just pure, keyboard-driven efficiency. Understand how to use the TUI to declare your forms.
- 04 Embed Forms: Embed your first form in a static web page and add a loading state before the form loads.
Building forms
You declare the form, Flux handles it. Let's deep dive on the how.
- Styles: Flux serves the form by default with beautiful styles that are inspired from ShadcnUI. You can customize the look by overriding specific classes or use "Naked mode" to make it really your own with custom CSS.
- Validation: When you declare a form you can declare custom validation for its fields. Flux then serves the form with client validation and after submission validates the data server-side (Regex, Min/Max lengths) to ensure data quality.
- States: Understand the User Experience flow and the different states (Success, Error, and Loading states) of a form.
- Deployment: Ready for prod? Follow this step-by-step guide to deploying on a VPS using Systemd and Caddy (HTTPS).
Infrastructure and security
Flux is built on a Hexagonal Architecture designed for security. We encrypt every sensitive information at rest and keep decryption keys in RAM only.
- Architecture: Deep dive into the single-binary structure and AES-GCM encryption.
- Captcha: Protect your inbox from spam bots by using the best captcha providers out there. At the moment Flux supports reCAPTCHA and Turnstile, but it will roll out with its own captcha soon enough!
- Notifications: Decouple your forms from your delivery methods. This allows easy composition of custom notifications. For now Flux supports Email notifications.
Privacy and GDPR compliance
Privacy is not just a feature; it is the core philosophy of Flux. We provide the tooling you need to survive in a post-GDPR world.
- Tools for privacy: Overview of the tools that Flux gives you for generating privacy focused forms and the best practices that you need to follow to ensure compliance easily.
- Global Privacy Rules: A comparison of different regulations like GDPR (Europe), CCPA (California), and PIPL (China). This will give you an understanding of how to create better forms for your audience.
- Proof of Submission: Understanding the concept of Accountability and how to easily prove that a user consented to your terms by creating a JSON audit trail generated for every user consent.
Project Status
Flux is open-source software built on the modern Go ecosystem.