cli + tui to publish to leaflet (wip) & manage tasks, notes & watch/read lists 馃崈
charm
leaflet
readability
golang
1---
2title: Getting Started with Leaflet
3sidebar_label: Getting Started
4description: Prerequisites, app passwords, and authentication commands.
5sidebar_position: 2
6---
7
8# Getting Started with Leaflet
9
10## Prerequisites
11
12- Noteleaf installed and configured
13- A BlueSky & [Leaflet](https://leaflet.pub) account (create at [bsky.app](https://bsky.app))
14- App password for authentication
15
16## Creating an App Password
17
18For security, Noteleaf uses app passwords instead of your main BlueSky password:
19
201. Go to [bsky.app/settings/app-passwords](https://bsky.app/settings/app-passwords)
212. Click "Add App Password"
223. Name it "noteleaf" or similar
234. Copy the generated password (you won't see it again)
24
25### Authentication
26
27Authenticate with your BlueSky handle and app password:
28
29```sh
30noteleaf pub auth username.bsky.social
31```
32
33You'll be prompted for the app password. Alternatively, provide it via flag:
34
35```sh
36noteleaf pub auth username.bsky.social --password <app-password>
37```
38
39**Re-authentication**: If your session expires, run `pub auth` again. Noteleaf remembers your last authenticated handle, so you can just run:
40
41```sh
42noteleaf pub auth
43```
44
45### Check Authentication Status
46
47Verify you're authenticated:
48
49```sh
50noteleaf pub status
51```
52
53Shows your handle and session state.