From a876d81f51b064a1e6fd76a819f6ea24a484bd9e Mon Sep 17 00:00:00 2001 From: Ayo Date: Sun, 27 Jul 2025 10:52:36 +0200 Subject: [PATCH] chore(yolk): add background to README --- README.md | 77 +++++++------------------------------------------------ 1 file changed, 9 insertions(+), 68 deletions(-) diff --git a/README.md b/README.md index 3d90a5da..4ce997a1 100644 --- a/README.md +++ b/README.md @@ -1,27 +1,16 @@ -

- - Elk logo - -

+# Yolk -

Elk alpha

+Hi! Yolk is my custom fork of [Elk](https://github.com/elk-zon/elk), a nimble Mastodon client. -

-A nimble Mastodon web client -

+I [decided](https://social.ayco.io/@ayo/114921112446517000) to have a personal fork of Elk because I really like the cross-account functionalities I use it for (e.g., I can open the Explore tab of my fosstodon account, then engage in a post with my self-hosted account, etc)... but I find sometimes I want to change little things which will make the app a bit more opinionated on my tastes (e.g., icons, colors, spacing, etc)... and some behavioral features. -
-

- discord chat - Open board on Volta -

-
+I think doing this will make me use it as my main app daily. I have been switching between multiple apps because each one have strengths & weaknesses of their own. -

- - Elk screenshots - -

+Crucial fixes (if I find them), quality of life improvements, and mastodon API feature parity will still go upstream to the main Elk project. + +~ Ayo Ayco + +--- ## ⚠️ Elk is in Alpha @@ -50,56 +39,8 @@ One could put Elk behind popular reverse proxies with SSL Handling like Traefik, > [!NOTE] > The provided Dockerfile creates a container which will eventually run Elk as non-root user and create a persistent named Docker volume upon first start (if that volume does not yet exist). This volume is always created with root permission. Failing to change the permissions of ```/elk/data``` inside this volume to UID:GID 911 (as specified for Elk in the Dockerfile) will prevent Elk from storing it's config for user accounts. You either have to fix the permission in the created named volume, or mount a directory with the correct permission to ```/elk/data``` into the container. -### Ecosystem - -These are known deployments using Elk as an alternative Web client for Mastodon servers or as a base for other projects in the fediverse: - -- [elk.fedified.com](https://elk.fedified.com) - Use Elk to log into any compatible instance -- [elk.mastodon.com.pl](https://elk.mastodon.com.pl) - Use Elk for the `mastodon.com.pl` Server -- [elk.me.uk](https://elk.me.uk) - Use Elk to log into any compatible instance, hosted on Google Cloud Run with no Cloudflare proxy -- [elk.h4.io](https://elk.h4.io) - Use Elk for the `h4.io` Server -- [elk.universeodon.com](https://elk.universeodon.com) - Use Elk for the Universeodon Server -- [elk.vmst.io](https://elk.vmst.io) - Use Elk for the `vmst.io` Server -- [elk.hostux.social](https://elk.hostux.social) - Use Elk for the `hostux.social` Server -- [elk.cupoftea.social](https://elk.cupoftea.social) - Use Elk for the `cupoftea.social` Server -- [elk.aus.social](https://elk.aus.social) - Use Elk for the `aus.social` Server -- [elk.mstdn.ca](https://elk.mstdn.ca) - Use Elk for the `mstdn.ca` Server -- [elk.mastodonapp.uk](https://elk.mastodonapp.uk) - Use Elk for the `mastodonapp.uk` Server -- [elk.bolha.us](https://elk.bolha.us) - Use Elk for the `bolha.us` Server -- [crab.bumscode.com](https://crab.bumscode.com) - Use [crab](https://github.com/maybeanerd/crab) - a soft fork of Elk - for the `bumscode.com` Server - > **Note**: Community deployments are **NOT** maintained by the Elk team. It may not be synced with Elk's source code. Please do your own research about the host servers before using them. -## πŸ’– Sponsors - -We are grateful for the generous sponsorship and help of: - - - NuxtLabs - -

- - StackBlitz - -

- -And all the companies and individuals sponsoring Elk Team and the members. If you're enjoying the app, consider sponsoring us: - -- [Elk Team's GitHub Sponsors](https://github.com/sponsors/elk-zone) - -Or you can sponsor our core team members individually: - -- [Anthony Fu](https://github.com/sponsors/antfu) -- [Daniel Roe](https://github.com/sponsors/danielroe) -- [三咲智子 Kevin Deng](https://github.com/sponsors/sxzz) -- [Patak](https://github.com/sponsors/patak-dev) - -We would also appreciate sponsoring other contributors to the Elk project. If someone helps you solve an issue or implement a feature you wanted, supporting them would help make this project and OS more sustainable. - -## πŸ“ Roadmap - -[Open board on Volta](https://volta.net/elk-zone/elk) - ## πŸ§‘β€πŸ’» Contributing We're really excited that you're interested in contributing to Elk! Before submitting your contribution, please read through the following guide.