blob: 28dcf2e4f99ff397689ce74bb39bf4ec6fb9418d (
plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
|
# Lustre examples
Each of the examples in this directory is a self-contained, complete Gleam app
that demonstrates a particular feature or concept of the library. For newcomers,
we recommend looking through them in order, as each example tends to build on
the previous ones. Feel free to jump in to any example that interests you, though!
**Note**: these examples all use [`lustre/ui`](https://github.com/lustre-labs/ui)
to show off something a little more visually interesting than unstyled HTML. None
of the ideas in these examples are specific to `lustre/ui`, though, and you should
know that you can follow along with any of these examples using only the standard
`lustre/element/html` module.
## Examples
- [`01-hello-world`](./01-hello-world) is a simple example to just get something
on the screen.
- [`02-interactivity`](./02-interactivity) introduces the core Model-View-Update
loop that underpins every Lustre application.
- [`03-controlled-inputs`](./03-controlled-inputs) demonstrates the most common
way to handle `<input />` elements in Lustre.
- [`04-custom-event-handlers`](./04-custom-event-handlers) shows you how to
write your own event handlers and decoders, instead of relying on the ones
provided by `lustre/event`.
- [`05-http-requests`](./05-http-requests) demonstrates how side effects are
handled in Lustre, using the third-party [`lustre_http`](https://hexdocs.pm/lustre_http/)
package.
- [`06-custom-effects`](./06-custom-effects) builds on the previous example and
shows you how to write your own side effects for Lustre to perform.
## Getting help
If you're having trouble with Lustre or not sure what the right way to do
something is, the best place to get help is the [Gleam Discord server](https://discord.gg/Fm8Pwmy).
You could also open an issue on the [Lustre GitHub repository](https://github.com/lustre-labs/lustre/issues).
While our docs are still a work in progress, the official [Elm guide](https://guide.elm-lang.org)
is also a great resource for learning about the Model-View-Update architecture
and the kinds of patterns that Lustre is built around.
|
