This branch is 247 commits behind coracle/flotilla:dev
mplorentz a42ba5446a Fix a docker rebuild issue (#88)
The Docker build wasn't making use of docker's cache because the .git directory was being copied into the build context. This means that even if the app did not change, if anything in git changed then docker would rebuild the entire app.

This excludes the .git folder from the docker build, instead relying on the user to pass in the build hash at build time. Which is annoying but I don't think there's a better way around it.

This was annoying me because I am deploying a self-hosted version of flotilla from a git branch via ansible and it was rebuilding flotilla every time.

Co-authored-by: mplorentz <mplorentz@noreply.gitea.coracle.social>
Reviewed-on: coracle/flotilla#88
Co-authored-by: Matt Lorentz <mplorentz@noreply.coracle.social>
Co-committed-by: Matt Lorentz <mplorentz@noreply.coracle.social>
2026-03-03 19:52:22 +00:00
2025-01-17 09:08:55 -08:00
2026-02-23 15:15:59 -08:00
2026-02-27 12:25:16 -08:00
2026-02-26 13:35:13 -08:00
2026-03-03 19:52:22 +00:00
2026-02-06 14:57:35 -08:00
2026-02-25 14:25:59 -08:00
2024-08-01 16:49:32 -07:00
2025-01-31 13:14:29 -08:00
2024-08-01 16:49:32 -07:00
2026-01-23 10:53:50 -08:00
2026-02-17 20:39:08 +00:00
2025-07-09 14:00:42 -07:00
2026-03-03 19:52:22 +00:00
2026-02-06 14:57:36 -08:00
2026-02-10 17:14:02 -08:00
2026-03-03 19:52:22 +00:00
2024-08-16 11:56:35 -07:00
2024-08-05 14:47:49 -07:00
2026-02-25 13:14:19 -08:00
2026-02-26 13:43:31 -08:00
2026-03-03 19:52:22 +00:00
2026-01-23 10:53:50 -08:00
2024-08-05 15:28:46 -07:00
2025-11-12 16:24:58 -08:00
2025-07-17 15:21:05 -07:00

Flotilla

A discord-like nostr client based on the idea of "relays as groups".

If you would like to be interoperable with Flotilla, please check out this guide: https://habla.news/u/hodlbod@coracle.social/1741286140797

Environment

You can also optionally create an .env file and populate it with the following environment variables (see .env for examples):

  • VITE_DEFAULT_PUBKEYS - A comma-separated list of hex pubkeys for bootstrapping web of trust
  • VITE_PLATFORM_URL - The url where the app will be hosted
  • VITE_PLATFORM_NAME - The name of the app
  • VITE_PLATFORM_LOGO - A logo url for the app. Can be a local path or https link. Must be a PNG file.
  • VITE_PLATFORM_RELAYS - A list of comma-separated relay urls that will make flotilla operate in "platform mode". Disables all space browse/add/select functionality and makes the first platform relay the home page.
  • VITE_PLATFORM_ACCENT - A hex color for the app's accent color
  • VITE_PLATFORM_DESCRIPTION - A description of the app

If you're deploying a custom version of flotilla, be sure to remove the plausible.coracle.social script from app.html. This sends analytics to a server hosted by the developer.

Development

See CONTRIBUTING.md.

Deployment

To run your own Flotilla, it's as simple as:

pnpm install
pnpm run build
npx serve build

Or, if you prefer to use a container:

podman run -d -p 3000:3000 ghcr.io/coracle-social/flotilla:latest

Alternatively, you can copy the build files into a directory of your choice and serve it yourself:

mkdir ./mount
podman run -v ./mount:/app/mount ghcr.io/coracle-social/flotilla:latest bash -c 'cp -r build/* mount'
S
Description
A discord-like nostr client based on the idea of "relays as groups".
Readme MIT 12 MiB
Languages
Svelte 78.5%
TypeScript 18.3%
CSS 0.9%
JavaScript 0.8%
Swift 0.5%
Other 0.9%