summaryrefslogtreecommitdiff
path: root/docs/README.md
blob: 8c37561bb451388a8d643bc1ce56f8a773b96fa4 (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
# Astal Docs

This directory contains the Astal documentation and Library references.
Hosted at [aylur.github.io/astal](https://aylur.github.io/astal/) and [aylur.github.io/libastal](https://aylur.github.io/libastal/)

## Commands

| Command           | Action                                      |
| :---------------- | :------------------------------------------ |
| `npm install`     | Installs dependencies                       |
| `npm run dev`     | Starts local dev server at `localhost:5173` |
| `npm run build`   | Build your production site to `./dist/`     |
| `npm run preview` | Preview your build locally                  |

## Add your creation to the showcases page

1. Add your image as a webp to `public/showcase`
2. Add it to `showcases/showcases.ts`
    - `src` should be `/astal/showcase/your-name-optional-title.webp`
    - `url` should point to the source code of the showcased widget/setup
    - `author` should be your name/nickname

```
.
├── public/showcase
│   └── your-name-optional-title.webp   # 1. add image
└── showcases/
    └── showcases.ts                    # 2. add information
```