Dismantle the 400-variable .env.example nightmare.
ISLAMU Configurator is an offline-first, client-side configuration engine that turns complex setup requirements into an intuitive, validated experience. Visual setup, instant syntax validation, Day-2 upgrade diffing, and direct secret vault provisioning across WebAssembly (Browser), Desktop (Avalonia), Terminal (TUI), and Headless CLI.
100% Client-Side Β· Zero Background Daemons Β· Zero Telemetry Β· Air-Gapped Secret Custody
π§ Active Pre-Release Development: There is no official release or public hosted Configurator app yet. You can build the clients or self-host the browser from this repository. Features and platform support are still being developed and verified; see current status.
Documentation Β· Roadmap Β· Quickstart Β· Packaging Β· Developer Guide Β· Sponsor
Setting up self-hosted software often means wrestling through hundreds of unvalidated environment variables, monolithic compose templates, and undocumented security keys. A single typo or missing connection string causes silent container boot crashes, while updating applications introduces breaking changes that lead to upgrade paralysis.
ISLAMU Configurator solves both sides of this equation:
- Application Maintainers describe their setup requirements once in a declarative, bounded YAML or JSON definition (
configurator.yaml). It defines the fields, validation rules, humanized explanations, secret policies, and target output files (.env, JSON, YAML). - Operators configure the software through an intuitive, validated experience across their choice of interface: an instant zero-install WebAssembly browser wizard, a native Desktop app, an 80x24 Terminal TUI over SSH, or a headless Machine CLI for automated pipelines.
Configurator runs 100% locally on your workstation. It requires no background daemon, collects zero telemetry, and performs zero unconfirmed network calls. Start with the overview, worked quickstart or FAQ.
Whether you are launching your first Docker container or managing dozens of enterprise clusters:
-
π’ The New Self-Hoster ("Zero-Guesswork Setup"):
- No Installation Required: Click a single "Configure Visually" link in an application's README to open an instant in-browser setup wizard powered by client-side WebAssembly.
- No More Mystery Variables: Clear visual indicators distinguish required obligations from optional tweaks.
- Human Explanations: Non-editable
"If omitted: <default>"callouts explain exactly what the software will do if a setting is left blank. - Catch Typos Before Booting: Live validation checks URLs, ports, IP ranges, and formats before you ever start a container, eradicating boot crashes.
- One-Click Export: Download a production-ready
.env, JSON, or YAML file directly to your machine.
-
π΅ The Advanced Operator & DevOps Engineer ("Deterministic Day-2 Control"):
- 4 Unified Surfaces: Seamlessly switch from the Browser to the keyboard-driven Terminal TUI (
Terminal.Gui) over SSH, the native Desktop GUI (Avalonia), or the headless Machine CLI (islamu-configurator) for CI/CD pipelines. - Eliminate Upgrade Paralysis (Day-2 Diffing): Drop your existing
.envinto the Version Migration Engine to immediately see newly mandatory keys, auto-migrated renames, and retired variables before pulling new releases. - Desktop Profile Vault: Automatically manage configuration profiles across environments (
development,staging,production) in~/.config/islamu-configurator/profiles/<app-id>/. - Direct Secret Vault Provisioning (Planned): Optionally apply reviewed changes to Infisical or Azure Key Vault from the native Desktop/TUI surfaces through
ISLAMU SecretKit, with zero network requests by default. Secret values never pass through vendor CLIs; an existingazsign-in can optionally be reused for authentication only (provider decision). After native pilots, a separate self-hosted connected Browser package may offer reviewed delta apply through an operator-owned connector; it is not implemented, and ISLAMU's public instance will never operate that proxy (Browser hosting decision).
- 4 Unified Surfaces: Seamlessly switch from the Browser to the keyboard-driven Terminal TUI (
Why open-source maintainers and software teams adopt Configurator:
- π Slash 80% of "Won't Boot" GitHub Issues: Stop spending hours debugging user syntax errors, missing DB passwords, or invalid port ranges. Configurator validates inputs on the client before the user ever runs your software.
- π οΈ Never Build a Setup Wizard Again: Do not waste weeks building custom React setup wizards, web installers, or Electron apps. Maintain one declarative schema (
configurator.yaml), and Configurator instantly powers web, desktop, terminal, and CLI setup experiences. - π¦ Collapse the Sprawl of
docker-compose.x.yamlPermutations: Stop maintaining dozens of fragmented files (docker-compose.sqlite.yml,docker-compose.postgres.yml,docker-compose.traefik.yml). A single Configurator definition conditionally emits the exact configuration required for any deployment topology. - π·οΈ The 1-Click README Badge: Add one line to your GitHub README:
[](https://configurator.islamu.org/?schema=https://raw.githubusercontent.com/org/repo/main/configurator.json)
- β‘ The 1-Click Release Notes Diff Button: When publishing breaking updates, include a direct diff link (
/diff?id=your-app&from=v1&to=v2) so users can visualize and resolve configuration changes before upgrading. - π€ Let AI Write and Verify Your Schema: You don't have to author schemas by hand. Our specialized AI Agent Skill (
configurator-integrate) crawls your repository docs and external documentation URLs, asks you multi-choice questions for ambiguities, boots a local Docker container to physically test that the schema works, and submits a pull request. - π Embeddable Quickstart Widgets: Embed the configuration wizard directly inside your documentation pages (Docusaurus, VitePress, GitBook) using a lightweight sandboxed iframe.
Start with the integration guide, definition cookbook or examples.
Given the universal agony of self-hosted configuration, why did the industry remain trapped in raw .env.example files and fragmented docker-compose.x.yaml permutations for 15 years? Five converging barriers blocked previous attempts:
- The DevOps Tragedy of the Commons: Application authors view deployment as an operations concern outside their scope; sysadmins write bespoke local scripts. Neither side owned the universal abstraction layer.
- The Commercial Walled-Garden Trap: Platforms like Unraid, TrueNAS, CasaOS, and Portainer built graphical setup templates, but deliberately locked them into their own proprietary background daemons and OS distributions to protect their platform moats.
- The Web SaaS Privacy Paradox: Operators rightfully refuse to paste production database passwords and API tokens into third-party cloud SaaS websites. Only the recent maturity of static, client-side WebAssembly (WASM) and zero-network execution allows an air-gapped web browser to serve as a zero-trust configuration engine.
- The Failure of Robotic JSON Schema UIs: Generic form generators produced rigid, unusable enterprise UIs lacking humanized explanations, wire-token toggles, and conditional defaults.
- The Pre-AI Authoring Bottleneck: Hand-crafting schemas for 300 variables required 40+ hours of tedious manual engineering per app. Modern AI agent skills with physical Docker boot verification collapse this authoring time to 3 minutes.
One declarative definition powers four purpose-built interfaces sharing the same stateless core engine:
| Interface | Best For | Platform Support | Secret Custody & Sync | Network / Offline Boundary | Step-by-Step Documentation |
|---|---|---|---|---|---|
| Static Browser | Zero-install onboarding, GitHub README deep links, doc widgets | Modern WebAssembly browsers | In-memory only; deliberate file download; no target connections or provider credentials | Client-side WASM; no telemetry or answer-bearing requests; public definition/assets may be fetched; ISLAMU public and default self-hosted static packages are target-disconnected | π Browser Hosting |
| Desktop GUI | Full workstation workflow, multi-environment profiles (dev/staging/prod) |
Linux (x64), macOS, Windows (Avalonia) | Protected Linux write (0600); planned Infisical & Azure Key Vault apply through SecretKit |
Fully offline; network only on explicit, confirmed secret vault action (planned) | π Desktop Guide |
| Terminal TUI | SSH sessions, headless servers, keyboard-driven power users | Linux, macOS, Windows (Terminal.Gui v2) | In-memory transient workspace; planned vault apply through SecretKit | Fully offline; zero background daemons | π Terminal Guide |
| Machine CLI | CI/CD automation, AI agent pipelines, headless verification | Linux (x64, arm64, musl), macOS, Windows | Stdin / files; masked diagnostics | Fully offline; native binary | π CLI Guide |
A separate self-hosted connected Browser package is planned, not implemented. It keeps editing and file composition in WebAssembly while an operator-owned authenticated connector performs explicitly reviewed secret-manager/PaaS deltas after native workflows are proven. It is not a mode of the current static image, and no ISLAMU-hosted connector is permitted. See the hosting decision.
See packaging for build instructions and platform limits. Protected native saving is currently verified on Linux; unsupported hosts refuse it. Browser downloads use the browser's ordinary download behavior. Offline browser use requires the app assets and a retained definition; answers are not restored between workspaces.
Keep the public YAML or JSON definition source with your application. Use
definition init, check, build and revise to create and maintain it, then
distribute the compiled definition with your release, through a browser host,
or on local media. GitHub and the optional Definition Store are distribution
choices, not requirements for local configuration.
One definition can serve the CLI, TUI, Desktop and Browser. It describes configuration requirements without running scripts or plugins. Definition revisions identify changes, and each open workspace retains the exact revision it loaded. Public definitions must never contain your operators' private answers.
Start with the adoption tutorial and
cookbook. The
definition reference explains formats,
defaults, presence and versioning. Product and public contract versions remain
0.0.1 during active development; breaking changes are expected.
Shape the configuration experience through your application's definition: its name, sections, entry points, field explanations, choices and translations. This lets maintainers present application-specific guidance without writing a separate form for every client.
- Application Identity: Give operators a clear application name and explicit version selection.
- Guidance & Localization: Explain settings and choices in the languages declared by your definition.
- Launch Experience: Link to a selected configuration entry and locale using the launch integration.
Available presentation features follow the supported definition format. A publisher label or application name is descriptive metadata, not proof of publisher identity.
The current configuration experience includes continuous Browser Compact editing, Guided steps, native Desktop task entry, and keyboard-driven Terminal workflows. See the qualification status for executed package and host checks and the remaining performance and assistive-technology evidence gates.
Configuration can include passwords, private keys and operational details. Configurator's security model focuses on where that data is processed, what a definition may do, and how files leave the workspace:
- Data-only definitions: Definitions describe supported fields and output mappings. They cannot execute plugins, scripts or arbitrary network calls.
- Stable sessions: An open workspace keeps its admitted definition revision and content identity, so a later definition update cannot silently change its requirements.
- Local browser processing: Answers and generated files stay out of application network requests and persistent caches. Secret entry requires consent for each workspace; revoking it clears secret fields and prepared output.
- Protected native saving: On verified Linux hosts, native saves create restricted files and refuse to overwrite existing ones. Unsupported hosts refuse protected saving instead of silently using an ordinary file write.
- Explicit application control: Preparing configuration does not log into your application, change a running service or grant administrative access.
These are specific safeguards, not a security certification or a guarantee against a compromised device. See the security policy, browser trust guidance and native output guide.
It helps you turn application requirements into usable configuration files. Open a definition, work through its settings, review validation and prepare its declared outputs, such as .env, JSON or YAML. A definition can describe nested structures and multiple files, so the workspace can cover much more than a short installation wizard. See the worked quickstart.
An application needs a definition describing the settings and file mappings Configurator should use. Maintainers can author one with the integration tools; operators can use an existing definition. Configurator supports a bounded definition format, rather than every JSON Schema feature or automatic understanding of arbitrary applications. Schema import can scaffold a starting point that still needs maintainer review. The optional Definition Store helps distribute definitions, but is not required.
Choose the Browser for a guided workspace without native installation, Desktop for native forms and local file workflows, Terminal for keyboard-driven work in a local or remote shell, or CLI for scripts and agents. They share configuration semantics, but feature coverage and platform qualification differ. Browser-first development is the current adoption focus; a richer TUI workbench is part of the documented direction.
Locally. The static Blazor WebAssembly app runs forms, validation and file preparation in your browser, rather than sending answers to a Configurator server. It downloads public app assets and may retrieve a public definition before collecting answers. Answers and generated files are excluded from application requests, persistent storage and public caches. This local-processing choice costs a larger initial download; see why WebAssembly.
You still need to trust the delivered code, browser, extensions and device. For high-value secrets, prefer a reviewed local native build on a trusted machine. Native software also requires trust in its build and operating system. Browser secret entry is disabled initially and requires consent for each workspace. Enabling it keeps processing local; revoking consent clears secret fields and prepared output. Masking protects against casual viewing, not compromised code. See browser trust guidance.
Yes. Native clients can work with local definitions. For offline browser use, first load the complete app assets and explicitly retain the definition; installing a PWA shortcut alone is not enough. Browser answers are transient and are not restored in a new workspace. Offline use still requires trust in the downloaded code and device. See the offline guide.
You can also leave browser secret entry disabled and prepare an incomplete secret-deferred draft, then complete the indicated secret locations locally. Ordinary required settings must still be valid, and unresolved secret-dependent conditions can block preparation. Ordinary settings may themselves be confidential; a draft is not ready for deployment until completed and checked.
Yes. Supported local .json, .yaml and .env files can be assessed against an admitted definition. The Version Migration Engine compares an existing configuration against a new application schema release, highlighting newly mandatory keys, auto-migrated renames, and retired settings before you upgrade. Filling eligible fields is an explicit, deliberate action that preserves your existing values. See import and comparison.
Secret-manager provisioning is planned, not yet implemented. The accepted design (secret-store integration decision) separates concerns:
- Runtime Secret Consumption: Target applications (like ISLAMU Event) use the companion library
ISLAMU SecretKitto borrow secrets at runtime inside scoped callbacks (SecretMaterial.Use(...)) whose buffers are cleared afterwards. - Setup & Provisioning: On native Desktop, Terminal and CLI surfaces, Configurator will compare value-free key inventories and apply operator-confirmed changes to Infisical or Azure Key Vault through SecretKit only. Vendor CLIs never receive or print secret values.
- Sign-in: Infisical starts with a Universal Auth machine identity (OIDC sign-in through your identity provider is a planned expansion). Azure uses your organization's own Entra client ID, or, if you explicitly choose it, your existing
az loginas a credential source. - Browser Boundary: The ISLAMU public instance and current static self-hosted package have no target network calls or secret-manager/PaaS access. Public web vault work hands off to a native client. A separate self-hosted connected package is planned after native pilots, with the same local WebAssembly editor and an operator-owned authenticated reviewed-delta connector; no such connector is implemented, and ISLAMU will not operate one on the public instance.
Read the comprehensive Product Vision & Sovereign Infrastructure Strategy and Marketing & Adoption Strategy for detailed breakdowns of our non-profit mission, Islamic Value-Sensitive Design (I-VSD), AI agent QA testing matrices, and ecosystem distribution flywheels.
No. Configurator checks the requirements represented by the definition; it cannot prove every application-specific or deployment constraint. Review the files and use the target application's own validation and deployment process. Configurator does not apply configuration or restart services for you.
Saving and applying are also different steps. Native protected saving is verified on Linux and refuses existing-file conflicts. Browser downloads cannot enforce those protections or control clipboard/download history. Protect exported files yourself; clearing a workspace cannot retract them. See native output.
We are prioritizing the browser so application maintainers can offer an easy Configure link, with guidance, complex configuration editing and comparison in one workspace. The TUI is intended to grow into a full operator/developer workbench, including document editing. Schema-to-schema comparison and direct native secret-manager workflows remain longer-term plans.
Read the vision and approach, Terminal decision and current status for the distinctions. The wider ISLAMU roadmap is tracked in the Roadmap Kanban View; discuss Configurator proposals in GitHub Discussions.
There are many ways you can contribute to ISLAMU Configurator:
Non-Technical:
- π Report bugs
- π‘ Suggest features
- π Improve Public Documentation
- π Translate UI resource files and documentation
- π£ Spread the word in your community
Technical:
- π» Fix bugs & implement features
- π§ͺ Test configuration, privacy and file-saving behavior
- π Measure and improve responsiveness with large definitions
- π¨ Improve forms, keyboard navigation, translations and accessibility across clients
For local development and code contribution, install .NET SDK 10.0.404
and the pinned workloads described in PROJECTS.md. The following
Bash commands create a checkout, restore dependencies (network/cache required),
build it, and inspect native writer availability. They do not prepare target
configuration. If already in this checkout, skip clone and cd; rerunning restore
and build updates local build outputs.
git clone https://github.com/islamu-ngo/Configurator.git
cd Configurator
export TMPDIR="$HOME/.cache/agent-tmp"
mkdir -p "$TMPDIR"
dotnet restore Configurator.slnx --locked-mode
dotnet build Configurator.slnx --configuration Release --verbosity quiet
dotnet run --project src/Configurator.Cli --configuration Release -- doctor --machineThe CLI supports definition authoring, configuration validation and comparison,
local secret operations, and file preparation. Use --help for commands and
options, or --machine for structured JSON results. See the
CLI guide for workflows and the
command reference for the full vocabulary.
Choose a definition explicitly; no application is selected for you.
| Client | Start from the checkout | Packaged entry point |
|---|---|---|
| Machine CLI | dotnet run --project src/Configurator.Cli --configuration Release -- doctor --machine |
islamu-configurator |
| Terminal | dotnet run --project src/Configurator.Terminal --configuration Release -- --definition examples/minimal-self-hosted/setup-definition.json |
islamu-configurator-terminal |
| Desktop | dotnet run --project src/Configurator.Desktop --configuration Release -- /absolute/path/setup.json /absolute/path/output-directory |
islamu-configurator-desktop |
| Browser | Publish Configurator.Browser, then serve its complete wwwroot/ |
/ catalogue, /launch/<familyId> and pinned /open#src=β¦ |
The Desktop row is an invocation template: substitute an admitted local
definition and an existing trusted output directory. Terminal/Desktop launch
opens an interactive workspace; saving remains a deliberate later action.
The doctor command reports writer availability; it does not test whether a
particular destination can save files.
The maintained neutral family can be opened on your own Browser host at
/launch/4d8950ad-972c-4357-8605-7a7c89c05a17?appVersion=1.0&entry=setup&locale=en.
This is a relative route for your own host, not a link to an official deployment.
Configure a SPA navigation fallback for deep links, not missing framework assets.
Native preparation requires no Configurator backend, database or Event server.
- Review our Contribution Guidelines and Local Getting Started.
- Read the Project Guide for project responsibilities and targeted build/test commands.
- Check the authoritative Quick Reference (Invariants), Core Contract, and Governance Standards.
- AI-assisted coding agents must strictly follow
AGENTS.mdand.agents/contract/intents.yaml.
Contributors retain ownership of their contributions. Configurator's ISLAMU-owned source uses the MIT license; third-party material keeps its own terms. The Steward authorized the first-party Event transfer without changing Event's separate AGPL license or service covenant.
Keep source provenance, attribution and dependency notices intact. Do not assume Event's CLA automation or alternative-license terms govern this independent utility. See CONTRIBUTING.md and IP Governance.
Start with Public Guides to use Configurator or add support to your application. Use Internal Specifications when contributing to the engine, clients or security boundaries. Both live in this repository:
π Documentation Hub: docs/README.md routes you to the guide for your task.
- Overview & Mental Model β What Configurator is, how the 3-step model works, and interface comparisons.
- Quickstart β Step-by-step walkthrough preparing configuration offline.
- Glossary β Plain-language definitions for all domain concepts.
- CLI Reference β Automate validation, comparison, secret generation and file preparation.
- Terminal β Configure with the keyboard and save locally.
- Desktop β Edit through native forms and use protected saving.
- Browser Configuration β Configure in your browser, choose how to handle secrets, export files or host the app yourself.
- Launch Integration β Add a Configure link that selects a definition, version and starting task.
- Definitions β Describe your application's fields, rules and output files.
- Native Output β Save private files, understand conflicts and check platform limits.
- Packaging β Build native executables or publish the static browser app.
- Troubleshooting β Diagnostics, recovery steps, and platform limitations.
- Comparison β Architectural comparison with RunTipi, Backstage, Umbrel, Portainer, and Helm.
For developers contributing code, architecture reviewers, and AI agents, use the authoritative in-repository specifications in docs/README.md:
Use the current status to separate implemented behavior from qualification and future work, and the knowledge map to find the owning reference.
| Engineering Concern | Authoritative In-Repository Markdown File | What You Will Learn |
|---|---|---|
| Vision & Core Goals | VISION_AND_APPROACH.md | Browser-first adoption, the TUI workbench direction and the product's current boundaries. |
| Design Alternatives | DESIGN_ALTERNATIVES.md | Structured record of adopted, considered, and rejected architectural attempts. |
| Architecture Overview | ARCHITECTURE.md | Mermaid component diagrams, data flow pipeline, and layer dependency rules. |
| Developer Mental Model | PROJECTS.md | Actual project ownership and targeted commands. |
| Global Project Invariants | QUICK_REFERENCE.md | Offline authority, privacy and engineering constraints. |
| Clean Architecture | Runtime ADR | Core β Artifacts/Presentation β adapters, without Event assemblies. |
| Core Definition Contract | CORE_DEFINITION_CONTRACT.md | Bounded data admission, validation and canonical identity. |
| Coding Patterns & Conventions | GOVERNANCE.md | Naming, metadata, source documentation and scope discipline. |
| Testing Strategy | TESTING.md | Deterministic assertions, focused owners and measured evidence. |
| Operations & Build Verification | OPERATIONS.md | Native tooling, verification and execution evidence. |
| Machine CLI Contracts | CLI_CONTRACT.md | Closed operation vocabulary and output envelopes. |
| Browser Launch | LAUNCH_CONTRACT.md | Pinned bounded sources, transient custody and immutable sessions. |
| Protected Native Output | PROTECTED_ARTIFACTS.md | Create-only writes and unsupported-host refusal. |
| Documentation Architecture | DOCUMENTATION_ARCHITECTURE.md | Separate public guidance and technical source anchors. |
| AI Agent Contribution Contract | AGENTS.md / intents.yaml | Shared contribution contract and task intake. |
| Layer | Technology |
|---|---|
| Runtime | .NET 10, SDK 10.0.404 |
| Architecture | Independent Core, Artifacts and Presentation with four adapters |
| Machine CLI | Spectre.Console / Spectre.Console.Cli |
| Terminal | Official Terminal.Gui, centrally pinned with retained component notices |
| Desktop | Avalonia 12.1.3, CommunityToolkit.Mvvm |
| Public browser | Static Blazor WebAssembly / MudBlazor |
| Definition data | Bounded JSON/YAML, canonical SHA-256 identity |
| Protected output | Linux create-only native writes; other hosts fail closed |
| Dependencies | Central package versions, generated locks and retained notices |
| Tests | TUnit, bUnit, headless native controls and architecture/package tests |
Join the ISLAMU community on Discord and our GitHub Discussions. We follow a Code of Conduct in all our community channels.
Ask questions, share definitions, describe configuration problems, or show how you use Configurator. Reports from real application setups help us decide what to improve next.
Give us a Star βοΈ
If you discover a security vulnerability in ISLAMU Configurator, please report it responsibly instead of opening a public issue. We take all legitimate reports seriously and will investigate them promptly. See the Security Policy for more info.
To disclose any security issues, please email us at security@openislamu.org.
If you maintain a fork of ISLAMU Configurator and discover or fix a security vulnerability, please report it privately first using the process in our Security Policy instead of opening a public issue or public pull request before coordination.
We are grateful for security fixes from forks. Contributions must preserve Configurator's MIT and third-party licensing boundaries and include provenance and focused verification evidence.
If you cannot submit a patch, you can still help by privately sharing the vulnerability details, affected versions, reproduction steps, and the general remediation approach. The ISLAMU maintainers may then implement an independent fix.
| Amir Akrari |
|---|
![]() |
I am deeply grateful to all our amazing contributors.
Support ISLAMU Configurator's ongoing development, infrastructure, and open-source mission by becoming a financial sponsor.
-
Monthly Support : π Support Monthly via Stripe
-
One-Time Contribution: π Donate Once via Stripe
πΌ To discuss corporate sponsorship, custom invoicing, or enterprise partnerships, email us at contact@openislamu.org.
If your organization would like to support ISLAMU Configurator with in-kind tooling, infrastructure, or software licenses, please reach out to us at contact@openislamu.org.
We appreciate these generally available public-repository tools. They are not project-specific sponsorships.
- CodeRabbit: AI code reviews for pull requests.
- Codecov: Test coverage reporting.
- Socket.dev: Dependency security analysis.
- Imgbot: Automated image optimization.
- Coverity: Static analysis code scanning you can trust.
- SonarQube Cloud: Code quality and security analysis.
- ISLAMU Event: Event Platform & Management System.
- ISLAMU Configurator: Universal, Offline-first Software Configuration Assistant.
- I-VSD: Islamic Value Sensitive Design: A Framework for Provider-Mediated Software Solutions
- SecretKit: Unified secret management SDK for .NET
These projects support the wider ISLAMU ecosystem. Configuratorβs direct library dependencies are listed separately below.
- Infisical: An Open Source Secret Management Platform.
- MudBlazor: An Open Source Blazor UI library that simplifies the creation of beautiful websites and webapps.
- Penpot: An Open Source Design Tool.
- Plane: An Open Source Project Management Platform that unifies projects, knowledge and agents with all-in-one workspace: projects, wiki, and AI.
- Coolify: An Open Source Platform as a Service, alternative to Vercel, Heroku, Netlify, and Railway for easy deploying to your own servers.
- Weblate: An Open Source Translation Management Platform.
- Kener: An Open Source Status Page.
- [Formbricks][formbricks-link]: Optional surveys and feedback collection.
Our codebase is enriched by dozens of community-crafted .NET libraries. For the complete, centrally managed dependency list and version pins, see Directory.Packages.props.
- .NET: The application runtime.
- ASP.NET Core: Blazor web application tooling and the optional static browser host.
- Avalonia: Native desktop UI.
- Terminal.Gui: Official pinned terminal UI.
- CommunityToolkit.Mvvm: Desktop model/viewmodel support.
- Spectre.Console: CLI command and presentation support.
- YamlDotNet: Bounded YAML data processing.
- TUnit: Automated .NET tests.
- bUnit: Blazor component tests.
A heartfelt thank you to every open-source author and maintainer whose work (direct or transitive) helps make this project possible.
ISLAMU is built by one person β Amir Akrari β entirely on personal free time and personal funds.
ISLAMU (ASBL en formation) (Association Sans But Lucratif β a non-profit association in formation in Belgium) is being established as the operational and legal steward of all ISLAMU open-source projects and charitable activities. Once formally registered with legal personality, ISLAMU ASBL will assume full legal stewardship.
ISLAMU will not offer its open-source software as a hosted SaaS. Instead, sustainability is built on:
- Fundraising & Grants: Crowdfunding campaigns, foundation grants, and public-interest funding for open-source digital infrastructure
- Sponsorships: Ranked sponsorship tiers β sponsors receive recognition and visibility; every euro goes back into the non-profit
- Official Partnerships & Fleet Tooling: Organizations that want to offer ISLAMU software as a hosted service can become Official ISLAMU Partners. Partners are vetted, listed on the ISLAMU website, and actively recommended and marketed by ISLAMU. Official Partners receive access to ISLAMU Event Control Plane (our standalone fleet orchestrator that bridges multiple ISLAMU Event instances with PaaS engines like Coolify for automated provisioning, SLA management, and backups). ISLAMU does not compete with its partners by running a commercial SaaS; we empower our partners with tooling and referrals
- Consultation & Support β professional consulting around ISLAMU software deployment, customization, and integration
If you are a company or institution that wants to support this work, reach out at contact@openislamu.org or start a conversation in our Discord.
For any question or problem reporting, please consider opening a new issue or send an email to contact@openislamu.org or create a new post in our Discord Server.
You can find details here.
This project is licensed under the terms of the MIT license.
The Steward's transfer authority covers ISLAMU-owned material only. Third-party libraries, datasets, fonts and assets retain their respective licenses, disclaimers and other terms. See THIRD-PARTY-NOTICES.md, IP Governance and Transfer Provenance.
The configuration engine is independent of Event and any application it configures. The four clients share its definition and validation rules. Interactive clients share workspace behavior; native clients also use the protected file writer. The Browser uses only browser-safe components and keeps file export within browser capabilities.
Terminal.Gui uses the official pinned package, with dependency locks and retained notices. The framework decision explains its selection for the TUI, and the dependency history records the earlier fork's retirement. Local validation packages are not official releases; publication and signing follow the separate release process.
