kpbb

A HN/Reddit/Twitter/Tumblr alternative written in crystal

KPBB - (abandoned)

Originally stood for "Kemal Parrot Bulletin Board", but was not intended to release under that name. I'd be happy to help anyone interested in taking over this project

It was intended to be a general self-hosted Twitter/Reddit/Tumblr alternative with a focus on minimal use of javascript. Think if hackernews decided to have more features without becoming a giant SPA or abandoning it's minimalism. The only federation this project intended to use was going to be RSS feeds (inbound and outbound). I was interested in an optional "log in with your mastadon" account feature, also a "follow this channel/board as if it were a mastadon user" feature.

Autoposting into KPBB from external RSS feeds and inbound webhooks work well, logging in and posting/commenting works well, everything else will probably need polishing or implementing. Funny enough, outbound RSS feeds were never implemented.

Some of the SQL/ORM stuff was written before I fully understood the DB and PG modules, and some ORMs either didn't work or were too magical to use. Sentry (aka raven) logs DB queries for exceptions.

Majority of the code was written in 0.35, but some updates were made for 1.2.1

Screenshot

received_576739623582131_cropped

Documentation

# run server locally
sh/dev

# run cron locally
sh/dev_cron

Testing

take a look at my util functions for snapshots src/iomcr/snapshot/.

Test coverage is very high.

# run tests once
sh/test

# automatically re-run tests on file changes
sh/watch_test

There is a gitlab-ci.yml, so if you upload this to gitlab I don't know if it will run the tests automatically. The codebase was written using TDD (test driven design) so the coverage will be very high.

Compiling

See the Dockerfiles or sh/* files.

Deploying

Application was designed to run on Google Cloud Run or a VPS. Docker is optional for the VPS. The ./functions directory is required for some features to work correctly, but application is still usable without them. Basically just deploy them as google cloud function and put their URLs in your .env or environment.

If you do not want to put this behind cloudflare, you would need to spoof the cf-ipcountry header or remove the code related to it or set the .env value SPOOF_CFIPCC=us.

cloudbuild.yaml for Google Cloud probably does not work correctly/completely.

Note that server, cron, and migrate_up are seperate binaries. I'd probably merge them into one binary and have them run as commands like kpbb migrate, kpbb serve, kpbb cron if I were going to continue working on this.

Repository

kpbb

Owner
Statistic
  • 1
  • 0
  • 0
  • 0
  • 11
  • over 1 year ago
  • October 28, 2022
License

GNU Affero General Public License v3.0

Links
Synced at

Wed, 06 Nov 2024 16:04:41 GMT

Languages