coracle/README.md

# What is this?

Coracle is a web client for the Nostr protocol. While Nostr is useful for many things, Coracle focuses on providing a high-quality social media experience. Check it out at [coracle.social](https://coracle.social).

[Dufflepud](https://github.com/staab/dufflepud) is a companion server which you can self-host. It helps Coracle with things like link previews and image uploads.

Coracle is currently in _alpha_ - expect bugs, slow loading times, and rough edges.

If you like Coracle and want to support its development, you can donate sats via [Geyser](https://geyser.fund/project/coracle).

# Features

- [x] Chat
- [x] Threads/social
- [x] Search
- [x] Notifications
- [x] Link previews
- [x] Add notes, follows, likes tab to profile
- [ ] Show relative dates
- [ ] Mentions - render done, now reference in compose
- [ ] Image uploads
- [ ] An actual readme
- [ ] Server discovery and relay publishing - https://github.com/nostr-protocol/nips/pull/32/files
- [ ] Support invoices https://twitter.com/jb55/status/1604131336247476224
- [ ] Expand/collapse large threads
- [ ] NIP 05

# Bugs

- [ ] Add alerts for replies to posts the user liked
- [ ] Stack views so scroll position isn't lost on navigation
- [ ] Add notification for slow relays
- [ ] Separating events table into notes/reactions/etc would effectively give us a second index on kind.
- [ ] Clicking on a badge in the popover falls through, and might also crash
- [ ] Add a slider in settings so users can decide whether to go with fast relays, or wait for everyone to complete their queries. Most relevant for NoteDetail

# Changelog

## 0.2.3

- [x] Fix reactions - we'll show new reactions optimistically to avoid complexity in listeners

## 0.2.2

- [x] Show notification for new notes rather than automatically adding them to the feed
- [x] Improve slow relay pruning by using a timeout for each relay
- [x] Re-work feed loading - go to network first and fall back to cache to ensure results that are as complete as possible
- [x] Slightly improved context fetching to reduce subscriptions
- [x] Split person feeds out into separate components
- [x] Add timeout in scroller to keep polling for new results
- [x] Fix fall-through on user badge click on alerts page
- [x] Fix deletion of old events, be more aggressive

## 0.2.1

- [x] Exclude people from search who have no profile data available
- [x] Speed up note retrieval by sorting first when the filter isn't restrictive
- [x] Only show a certain number of replies on popular notes, with a link at the bottom showing total replies
- [x] Refine algorithm for which relays to drop when they don't send an eose. This helps avoid the "we couldn't find this note" error message on the note detail, since we were giving up too early.
- [x] Improve url detection and shortening

## 0.2.0

- [x] Completely re-worked data synchronization layer, moving from naive just-in-time requests to background listeners, loaders, and a local copy stored in dexie. Events and tags, but not people are deleted from the database on logout, and old events are periodically purged.
- [x] Added alert badge and page.
- [x] Improved relay page. Suggestions are now taken from
- [x] Removed chat to keep scope of work smaller. Let me know if you'd like to see that come back.
- [x] Split tabs out into separate components
- [x] Removed dispatch, added cmd instead
- [x] Added image previews in addition to link previews
- [x] Fixed infinite scrolling
- [x] Removed cursor/listener abstractions
- [x] Added some default pubkeys
- [x] Wait for some, not all relays to send eose to keep things fast
- [x] General refactoring and bugfixing
Update readme 2022-12-15 18:31:47 +00:00			`# What is this?`
Add chat 2022-11-24 19:47:03 +00:00
Fix alerts 2022-12-24 00:02:01 +00:00			`Coracle is a web client for the Nostr protocol. While Nostr is useful for many things, Coracle focuses on providing a high-quality social media experience. Check it out at [coracle.social](https://coracle.social).`
Update readme 2022-12-15 18:31:47 +00:00
			`[Dufflepud](https://github.com/staab/dufflepud) is a companion server which you can self-host. It helps Coracle with things like link previews and image uploads.`

			`Coracle is currently in _alpha_ - expect bugs, slow loading times, and rough edges.`
Add chat 2022-11-24 19:47:03 +00:00
Fix alerts 2022-12-24 00:02:01 +00:00			`If you like Coracle and want to support its development, you can donate sats via [Geyser](https://geyser.fund/project/coracle).`

Update readme 2022-12-15 18:31:47 +00:00			`# Features`
Add chat 2022-11-24 19:47:03 +00:00
Add support for custom relay urls 2022-11-27 03:34:28 +00:00			`- [x] Chat`
			`- [x] Threads/social`
Add link previews 2022-12-03 20:26:09 +00:00			`- [x] Search`
Move some stuff around 2022-12-15 13:55:12 +00:00			`- [x] Notifications`
Add sourcemaps 2022-12-06 05:46:40 +00:00			`- [x] Link previews`
Fix user detail tabs 2022-12-14 06:01:26 +00:00			`- [x] Add notes, follows, likes tab to profile`
Improve query speed when loading from dexie by sorting first 2022-12-24 21:50:18 +00:00			`- [ ] Show relative dates`
Update readme 2022-12-15 18:31:47 +00:00			`- [ ] Mentions - render done, now reference in compose`
			`- [ ] Image uploads`
Move some stuff around 2022-12-15 13:55:12 +00:00			`- [ ] An actual readme`
Add link previews 2022-12-03 20:26:09 +00:00			`- [ ] Server discovery and relay publishing - https://github.com/nostr-protocol/nips/pull/32/files`
Working on scrolling stuff 2022-12-17 20:30:18 +00:00			`- [ ] Support invoices https://twitter.com/jb55/status/1604131336247476224`
Fix alerts 2022-12-23 19:59:40 +00:00			`- [ ] Expand/collapse large threads`
			`- [ ] NIP 05`
Update readme 2022-12-15 18:31:47 +00:00
			`# Bugs`

			`- [ ] Add alerts for replies to posts the user liked`
			`- [ ] Stack views so scroll position isn't lost on navigation`
Working on loading 2022-12-20 13:48:28 +00:00			`- [ ] Add notification for slow relays`
Improve query speed when loading from dexie by sorting first 2022-12-24 21:50:18 +00:00			`- [ ] Separating events table into notes/reactions/etc would effectively give us a second index on kind.`
			`- [ ] Clicking on a badge in the popover falls through, and might also crash`
			`- [ ] Add a slider in settings so users can decide whether to go with fast relays, or wait for everyone to complete their queries. Most relevant for NoteDetail`
refactor everything with dexie 2022-12-16 17:45:58 +00:00
Fix alerts 2022-12-24 00:02:01 +00:00			`# Changelog`

Update changelog 2022-12-26 21:37:47 +00:00			`## 0.2.3`

			`- [x] Fix reactions - we'll show new reactions optimistically to avoid complexity in listeners`

Switch from cache-first to cache-last by always attempting to retrieve messages from the network with an aggressive timeout. 2022-12-26 17:43:55 +00:00			`## 0.2.2`

			`- [x] Show notification for new notes rather than automatically adding them to the feed`
			`- [x] Improve slow relay pruning by using a timeout for each relay`
			`- [x] Re-work feed loading - go to network first and fall back to cache to ensure results that are as complete as possible`
			`- [x] Slightly improved context fetching to reduce subscriptions`
			`- [x] Split person feeds out into separate components`
			`- [x] Add timeout in scroller to keep polling for new results`
Update readme 2022-12-26 21:12:38 +00:00			`- [x] Fix fall-through on user badge click on alerts page`
			`- [x] Fix deletion of old events, be more aggressive`
Switch from cache-first to cache-last by always attempting to retrieve messages from the network with an aggressive timeout. 2022-12-26 17:43:55 +00:00
Improve query speed when loading from dexie by sorting first 2022-12-24 21:50:18 +00:00			`## 0.2.1`

			`- [x] Exclude people from search who have no profile data available`
			`- [x] Speed up note retrieval by sorting first when the filter isn't restrictive`
			`- [x] Only show a certain number of replies on popular notes, with a link at the bottom showing total replies`
			`- [x] Refine algorithm for which relays to drop when they don't send an eose. This helps avoid the "we couldn't find this note" error message on the note detail, since we were giving up too early.`
			`- [x] Improve url detection and shortening`

Fix alerts 2022-12-24 00:02:01 +00:00			`## 0.2.0`

Add changelog, wait for only some relays to eose 2022-12-24 00:36:17 +00:00			`- [x] Completely re-worked data synchronization layer, moving from naive just-in-time requests to background listeners, loaders, and a local copy stored in dexie. Events and tags, but not people are deleted from the database on logout, and old events are periodically purged.`
			`- [x] Added alert badge and page.`
			`- [x] Improved relay page. Suggestions are now taken from`
			`- [x] Removed chat to keep scope of work smaller. Let me know if you'd like to see that come back.`
			`- [x] Split tabs out into separate components`
			`- [x] Removed dispatch, added cmd instead`
			`- [x] Added image previews in addition to link previews`
			`- [x] Fixed infinite scrolling`
			`- [x] Removed cursor/listener abstractions`
			`- [x] Added some default pubkeys`
			`- [x] Wait for some, not all relays to send eose to keep things fast`
			`- [x] General refactoring and bugfixing`