package ocamlmerlin-mlx
Install
Dune Dependency
Authors
Maintainers
Sources
sha256=3762bbc75264b0d67972cc1b97eefe083aa0032500a45bab7f6e698ccf9b378c
sha512=bfefa488d68f84f3df9196e93b76eaf23452e04258cfaaaa0726bd1c9deed7a357145f19d19df6e84909ce40fe6a81b53e66f6dd7ec8931c57bde46b0e562dca
Description
Published: 23 Jun 2025
README
mlx
An OCaml syntax dialect which adds JSX expressions to the language.
let header ~title () =
<header>
<h1>title</h1>
</header>
let page =
<html>
<body>
<header title="Hello, world!" />
<div>
"Some content goes here"
</div>
</body>
</html>This code is transformed into the following OCaml code:
let header ~title () =
header () ~children:[ h1 () ~children:[ title ] [@JSX]; ] [@JSX]
let page =
html () ~children:[
body () ~children:[
header () ~title:"Hello, world!" [@JSX];
div () ~children:[ "Some content goes here" ] [@JSX];
] [@JSX];
] [@JSX]It is expected to use mlx-pp preprocessor with either a runtime lib which provides the implementation of such functions or a ppx which which further transforms [@JSX] attributes into the desired output.
Installation & Usage
Use the following commands to install the necessary packages:
opam install mlx ocamlmerlin-mlxTo make dune consider .mlx files as OCaml files you need to configure an mlx dialect, put this in your dune-project file:
(dialect
(name mlx)
(implementation
(extension mlx)
(merlin_reader mlx)
(preprocess
(run mlx-pp %{input-file}))))Editor Support
VS Code
Syntax highlighting support for VS Code is still work in progress. As a temporary workaround, you can enable basic OCaml syntax highlighting by adding this to your settings:
{
"files.associations": {
"*.mlx": "ocaml"
}
}Neovim
For Neovim users, install plugin: https://github.com/ocaml-mlx/ocaml_mlx.nvim
Useful Links
- Example with Dream web framework: https://github.com/aantron/dream/pull/330
- Template ReasonReact project: https://github.com/andreypopp/melange-mlx-template
- mlx announcement on OCaml Discourse: https://discuss.ocaml.org/t/ann-mlx-syntax-dialect/15035