···11# blento
2233-Alpha version can be tried at https://blento.app
33+public beta version can be tried at https://blento.app
4455-Your personal website in a bento style layout, using your bluesky personal data server as a backend.
55+Your personal website in a bento style layout, using your atproto personal data server (the tech that bluesky runs on) as a backend.
6677made with svelte, tailwind and hosted on cloudflare workers.
88···12121313This started as a replacement/alternative for bento.me which is shutting down in a few weeks (Feb 2026) after being bought by a competitor ^^ I wanted to build a version that couldn't just shut down or where it would be very easy to spin up a new version (with all the data) should the old one disappear.
14141515-That's why all your data is saved on your bluesky personal data server, so you can start setting up your website on blento.app, but then anytime you want to start self hosting you easily take your data with you (dedicated forks optimized for self hosting on different platforms coming soon).
1515+That's why all your data is saved on your atproto personal data server, so you can start setting up your website on blento.app, but then anytime you want to start self hosting you easily take your data with you (dedicated forks optimized for self hosting on different platforms on the roadmap).
16161717Should blento.app shut down at some point, someone else can also spin up a new version that shows all blentos (note: it's MIT licensed so you _could_ do that now too and offer a competing service, but please don't (except for self-hosting your own profile ofc), legal != nice).
18181919-One other note: for most independence I encourage everyone to get their own domain and either self host or redirect to blento.app/your-profile (still working on a way to make this as easy as possible for non-technical users, if you have any suggestions please reach out).
2020-2121-## Selfhosting
2222-2323-See [docs/Selfhosting](./docs/Selfhosting.md).
1919+One other note: for most independence I encourage everyone to get their own domain see [how to setup a custom domain](./docs/CustomDomain.md), selfhosting on the other hand while currently possible is not encourage *yet* before this project reaches a more stable state (if you do want to selfhost though, see [here](./docs/Selfhosting.md)).
24202521## Making Custom cards
2622···28242925## Contributing
30263131-See [docs/Contributing](./docs/Contributing.md)
2727+Contributions are very welcome, see [docs/Contributing](./docs/Contributing.md) for more info.
32283329## Idea for a card?
34303535-Open an issue
3131+Open an issue, see [here](https://github.com/flo-bit/blento/issues/93) for card ideas that are already planned.
36323733## License
3834
+10-4
docs/Contributing.md
···11# Contributing Guidelines
2233-Contributions are very welcome ๐
44-53For creating new cards see [here](CustomCards.md) (and check out [existing card ideas](CardIdeas.md))
6475## Development
···16141715## AI assisted development
18161919-You can submit PRs written with AI but please make sure:
1717+You can submit PRs written with AI assistance but please make sure:
20182119- there's no extra unnecessary changes/unnecessary verbose code (keep it simple)
2222-- you test everything yourself (in light/dark mode, with and without colored cards, in edit mode and not in edit mode)
2020+- you test everything yourself
2121+ - in light/dark mode
2222+ - with and without colored cards
2323+ - in edit mode and not in edit mode
2424+ - on mobile and desktop (note that there's two different mobile "modes", one dependent on screen size and one enabled when pointer: coarse)
2525+2626+## Subpages
2727+2828+currently subpages exist but are not used yet, they are perfect for testing things though (as otherwise your profile on blento.app will show e.g. cards that dont exist on the deployed version yet), in the development verion go to `/your.handle/{pagename}/edit` to edit a subpage (where pagename can be any string that is not "edit" or "api") (note that currently when you login you always get redirected to your main page)
+7-3
docs/CustomCards.md
···11# Custom Cards
2233-see `src/lib/cards` for how cards are made (and e.g. `src/lib/cards/EmbedCard/` and `src/lib/cards/LivestreamCard/` for examples of implementation).
33+see `src/lib/cards` for how cards are made.
4455Notes:
6677-- Cards should be styled to work in light and dark mode (with dark: class modifier) as well as when cards are colorful (= bg-color-500 for the card) (with accent: modifier).
88-- Please test newly created cards both when editing (/your-user/edit) and in your user profile when saved (/your-user)
77+- Cards should be styled to work in light and dark mode (with dark: class modifier) as well as when cards are colorful (= bg-color-400/500 for the card) (with accent: modifier).
88+- Please test newly created cards:
99+ - in light/dark mode
1010+ - with and without colored cards
1111+ - in edit mode and not in edit mode
1212+ - on mobile and desktop (note that there's two different mobile "modes", one dependent on screen size and one enabled when pointer: coarse)
+5
docs/CustomDomain.md
···11+# Custom domain
22+33+For most independence I encourage everyone to get their own domain that redirects to blento.app (with a CNAME redirect), to connect your custom domain, on blento.app click on your profile icon in edit mode (top right corner) and select "custom domain".
44+55+If you want to buy a domain, I suggest cloudflare, as they sell domains at-cost and for root domains (like domain.com instead of blento.domain.com), cloudflare also offers CNAME flattening.
+12
docs/Roadmap.md
···11+# Roadmap
22+33+more specific roadmap coming soon.
44+55+- more cards (especially atmosphere cards) (see https://github.com/flo-bit/blento/issues/93)
66+- make subpages actually usable for everyone
77+- basic analytics
88+- lots of bug fixing/QoL improvements
99+- maybe: supporter/"pro" features?
1010+- move auth to backend
1111+- lexicon
1212+- general cleanup
+5
docs/Selfhosting.md
···11# Selfhosting with cloudflare workers
2233+I currently advise everyone to *not* selfhost, as long as this project is still in the beginning stages with lots of changes every day, isntead I'd suggest setting up a custom domain (see [here](./CustomDomain.md)) and only later once this project is more stable to selfhost, thanks to the magic of atproto, you'll just have to change where your domain points to and setup the selfhosted version and your content will magically transfer over.
44+55+If you do still want to give selfhosting a try now, some features/cards may break on your selfhosted version, in that case sync with the upstream repo.
66+77+381. fork this repo
492. create a cloudflare worker application and connect it to your fork
5103. change the vars in `wrangler.jsonc` (including https:// in the PUBLIC_DOMAIN var!)