singlestage 0.3.8

A UI component library for Leptos based on Basecoat UI and shadcn/ui
Documentation 
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
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92

# Singlestage UI

A familiar UI library for [Leptos](https://leptos.dev) made with [Tailwind
CSS](https://tailwindcss.com), Based on [Basecoat](https://basecoatui.com),
[shadcn/ui](https://ui.shadcn.com), and [Radix](https://radix-ui.com).

[https://singlestage.doordesk.net](https://singlestage.doordesk.net)

## Introduction

Singlestage takes the familiar styling of [Radix](https://radix-ui.com/) and
[shadcn/ui](https://ui.shadcn.com/) and brings it to [Leptos](https://leptos.dev). It takes a
modular approach, meaning every component is feature flagged so you can take as much or as little
as you need.

Each component tries to stay lean, using semantic HTML elements, modern APIs, and CSS instead of
Rust code wherever possible. This keeps WASM binaries small while staying current with emerging
accessibility features.

## Features

- Conforms to modern web standards
- WAI-ARIA compliant
- Focused on minimalism, modularity, and performance
- Feature flagged components
- Modular theme system
- Dark mode that just works
- Arbitrary theme support
- HTML-like API

## Install

Add singlestage with cargo:
`cargo add singlestage`

Or add singlestage to your Cargo.toml:

```toml
# Cargo.toml

[dependencies]
leptos = "0.8"
...
singlestage = "0.3"
```

### Nightly

```toml
# Cargo.toml
[dependencies]
leptos = { version = "0.8", features = ["nightly"] }
...
singlestage = {version = "0.3", features = ["nightly"] }
```

Add the nightly feature to singlestage just as you do with Leptos, if using nightly.

### Islands

Add the islands feature to singlestage just as you do with Leptos, if using islands.

```toml
# Cargo.toml

[dependencies]
leptos = { version = "0.8", features = ["islands"] }
...
singlestage = {version = "0.3", features = ["islands"] }
```

### SSR

Nothing special needs to happen whether you you use SSR or not.

### Tailwind BYOB

Singlestage uses tailwind during the build process. It first checks for `tailwindcss` in
`PATH` (system install, typical for Linux). If that doesn't work then it tries to download the
latest tailwind binary from their github release page. If for some reason this fails, or for
whatever reason you want to use your own tailwind executable, you can bring your own binary by
setting the `SINGLESTAGE_TAILWIND_PATH` environment variable to the full path (from root) to your
tailwind binary. Note that if you download the binary from github on Linux or MacOS then you'll
probably have to make it executable (`chmod +x`).

```bash
SINGLESTAGE_TAILWIND_PATH=/path/to/tailwindcss cargo leptos watch
```

## Contributing

Contributions are welcome.