1 files changed, 65 insertions, 9 deletions
diff --git a/pages/reference/for-react-devs.md b/pages/reference/for-react-devs.md
index 9a14652..96cc323 100644
--- a/pages/reference/for-react-devs.md
+++ b/pages/reference/for-react-devs.md
@@ -8,35 +8,91 @@ and want to get up to speed quickly.
 
 ### Setup a new project
 
-**In React**...
+**In React** you are encouraged to use a meta framework like Next.js or Remix. To
+start a barebones project you need to run `npm install react react-dom`. You will
+typically use a bundler that can transpile JSX like `npm install --save-dev vite`.
+Many modern projects use TypeScript as well: `npm install --save-dev typescript`.
+A simple hello world might look like this:
 
-**In Lustre**...
+```jsx
+// src/index.js
+import { createRoot } from "react-dom/client";
+
+const root = createRoot(document.getElementById("app"));
+
+root.render(<h1>Hello, world</h1>);
+```
+
+To run the project you could use Vite's development server with `npx vite`.
+
+**In Lustre** you need to install the `lustre` package with `gleam add lustre`.
+Most Lustre projects will add the dev tools too with `gleam add --dev lustre_dev_tools`.
+A simple hello world might look like this:
+
+```gleam
+// main.gleam
+import lustre
+import lustre/element/html
+
+pub fn main() {
+  let app = lustre.element(html.h1([], [html.text("Hello, world")]))
+  let assert Ok(_) = lustre.start(app, "#app", Nil)
+}
+```
 
 ### Render some HTML
 
-**In React**...
+**In React** you can use JSX to render HTML elements. JSX is a syntax extension
+for JavaScript that looks like HTML that lets you interpolate JavaScript expressions
+into your markup. Here's an example:
 
-**In Lustre**...
+```jsx
+<button className="primary">Click me</button>
+```
+
+**In Lustre** HTML is rendered by calling functions (this is what JSX compiles to
+as well).
+
+```gleam
+button([class("primary")], [text("Click me")])
+```
 
 ### Render some text
 
-**In React**...
+**In React** a string is a valid type of React node, so you can render text by
+just writing it in your JSX:
 
-**In Lustre**...
+```jsx
+Hello;
+```
 
-### Handle events
+To concatenate text with other variables or expressions, you can use curly braces:
+
+```jsx
+Hello {name}
+```
+
+**In Lustre** because of Gleam's type system, all elements must be Lustre's `Element`
+type. To render text you need to use the `text` function:
+
+```gleam
+text("Hello")
+text("Hello" <> name)
+```
+
+### Manage state
 
 **In React**...
 
 **In Lustre**...
 
-### Write a component
+### Handle events
 
 **In React**...
 
 **In Lustre**...
 
-### Manage state
+### Write a component
 
 **In React**...