Documentation
These pages teach selm the way a good language guide should: start simple, build a clear picture, then go deeper when you need to.
selm looks a lot like Elm. You write .selm files. Choose a target in selm.toml: JavaScript for browser apps, or Erlang/BEAM for servers, databases, and server-rendered HTML.
A good path for beginners
You do not need to read everything. Follow this order if you are new:
- 1. Quick startInstall the CLI and run a Hello world in a few commands
- 2. Language tourTry core syntax in the browser with no install
- 3. How it worksThe mental model: targets, TEA, and where state lives
- 4. ExamplesCopy a working app and learn by changing it
- 5. LanguageServers, channels, databases, and migrations
- 6. FormsChangesets, field errors, and submit branching
Already know Elm? Skim Differences from Elm, then jump into How it works or Examples.
Everything else
- From ElmOR-patterns, guards, :=, and other forms beyond Elm
- InstallPrerequisites and building from a checkout
- EditorVS Code, Cursor, and Spacemacs
- FormsValidate inputs with Changeset and Changeset.Validate
- Html SSRServer-rendered HTML on the BEAM
- PackagesLocal packages and Hex
- selm.tomlProject manifest keys, targets, and dependencies
- AITalk to tools over MCP and ACP
- CLIEvery command and a typical project layout
- ConfigurationPorts, databases, and JWT secrets in your app
- StdlibBuilt-in modules and functions