Implementing the feed
Tags: jobs, reframe, clojurescript, isomorphism
Published: 2020-10-02 16:33:41


If you've visited WorksHub, or one of our sites in the last few weeks then _hopefully_ you've noticed that we launched a new landing page and dashboard which revolves around what we call "the feed". In this blog I aim to talk a little bit about how we implemented the feed into our isomorphic Clojure/ClojureScript application (some of which you can see [here](https://github.com/WorksHub/client) by the way). 

## The what now?
Most of us are familiar with the concept of a 'feed' in the digital realm. It's even in the dictionary: "a facility for notifying the user of a blog or other frequently updated website that new content has been added." Splendid. That's exactly what it is.

## Under the bonnet
We started out by assessing our options with respect to how we were going to power the feed, and specifically, the first question we always ask is '_are we going to build this ourselves or use an off-the-shelf solution?_' Answering this question is complex and there are various factors to consider, including but not limited to:
* **Storage** - how and where do we store the data?
* **Availability** - how do we ensure it's always available?
* **Performance** - how do we serve the data as quickly as possible?
* **Resources** - how long will it take us to create a solution? do we have the experience in our team to even do it? how much will it cost to _buy_ a solution?
* **Security** - what are our security obligations? what are the risks and how do we mitigate these?

Answering these questions inevitably spawns more questions, until we're in a kind of giant _question tree_(!). Cue research, planning, competitor analysis, design and a lot of chin stroking. 

Here at WorksHub we are light on operational resources and so our stack choices bias toward managed services or pieces that are easy to maintain. With this in mind we started with an appraisal of existing, off-the-shelf products and eventually we settled on developing a proof-of-concept using a technology called _Stream_.

![stream](https://workshub.imgix.net/4ecc495182111ca95c0eed722cb2fa4c)

[Their website](https://getstream.io) - and [they are hiring!](https://www.works-hub.com/companies/stream/jobs)

One of their products is literally called 'Feed' and, from their own sales material, _"Build scalable activity feeds in hours instead of months. Scale your activity feed without the notorious difficulties involved with building activity feeds on traditional databases."_ 

We did some digging into Stream and the technology that runs their service. Amazingly, Thierry Schellenbach - the CEO of Stream - persists [a version](https://github.com/tschellenbach/Stream-Framework) on his personal GitHub account. The repository is a gold mine of information relating to the _how's_ and _why's_ of Stream's inner design and workings. For example:
* It's written in Python with Celery - fantastic choices.
* It's backed by Redis and/or Cassandra - both highly regarded data stores.
* The code is well maintained and there is extensive documentation.

We actually spoke to Stream directly about this and they informed us that their _actual_ product

These factors, combined with the knowledge that we could use the repository - code and comprehensive documentation - to answer philosophical questions made Stream a strong option and, after our proof-of-concept was successful we decided to commit to one of their managed packages.

### Why not build it ourselves?
At WorksHub we try as hard as possible to run a lean, focused technical function and this hugely influences our decisions about what we _build_ and what we _buy_. If a commercial solution exists and is within our capacity then that is our preference, because our business is in creating opportunities for software developers, not [reinventing the wheel.](https://en.wikipedia.org/wiki/Not_invented_here)

## Revving the engine
Well, there's a fair amount of code that exists between Stream's service and our frontend. Our backend (written in Clojure) is responsible for generating 'activites' - things that appear on the feed - and relaying those to Stream. From trivial activities, such as 'new job' or 'new article' (possibly where you first learned about this one?), to more complex activities such as deciding whether a job or an issue is 'trending'. We handle all of that ourselves and then, upon request, Stream sends us a paginated, filtered, joined collection of these activities which are destined for either a public landing page, a particular tag page or a user's dashboard. What you get back depends on what exactly you ask for. Internally there are several (hundred) individual 'feeds' which are stitched together - based on certain rules about who's following who - and provided as a single list.

![blog4.png](https://functionalworks\-backend\-\-prod.s3.amazonaws.com/logos/d811169b7931ca02234b6541bd5c8fc1)

As an example, anything tagged with 'Clojure' is added to a dedicated Clojure feed. If you visit [https://functional.works-hub.com/feed?tags=clojure%3Atech](https://functional.works-hub.com/feed?tags=clojure%3Atech) you can view this feed in isolation. When you visit the Functional Works landing page however, you see a feed that 'follows' Clojure as well as a bunch of other feeds such as Elixir, Scala, F# etc. Similarly, other landing pages (Javascript, Golang etc) follow feeds that are relevant to them and their respective ecosystems (although there's actually a lot of overlap).

To facilitate our backend communicating with Stream we introduced a new library, [Shyvana](https://github.com/WorksHub/shyvana), which is a wrapper around Stream's own [stream-java](https://github.com/getstream/stream-java) library. This means we can avoid additional Java interop in our backend...and, in the process make it easier for any other Clojure developers to interact with Stream!

## Racing stripes
In case you haven't wandered over to our [client repository](https://github.com/WorksHub/client) yet, we use an [isomorphic](https://en.wikipedia.org/wiki/Isomorphic_JavaScript) ClojureScript framework called [re-frame](https://github.com/day8/re-frame) in order to build the frontend. The benefit of such an approach is that we get all the "good stuff" of single-page applications (modelling, interactivity, dynamism, etc) along with all the "good stuff" of server-side rendered pages (SEO, performance, caching etc). Stay tuned for an article about this in the future!

We use GraphQL (via our own wrapper library, [Leona](https://github.com/WorksHub/leona) - do you recognise the references?) to retrieve data from the backend. We make an effort handle the data from Stream _as little as possible_ before sending it to the client so as to minimize pressure on our side. We also cache recent results so that we can avoid excessive requests. This all means that whether the request originates from the client as XHR or whether it originates within the server as part of a server-side render, the request handling, the cache coverage and any data transformation is actually performed by the same Clojure code, compiled into two separate environments.

## Wrap up
Choosing Stream as a technology to help us deliver this feature was a critical decision and allowed our technical team to focus on the domain problems we were trying to solve - delivering bespoke, dynamic content for software engineers to help them learn, grow and find jobs they want - rather than get bogged down with complex infrastructure and operations. The choice was heavily motivated by our ability to fully understand the Stream product as a result of the fact that it began life as an open source project.

As an honourable mention, using a power combo such as Clojure and ClojureScript allowed us to move very quickly and prove out the assumptions we had made about how the feeds would compose and work with our tag system. The decision to commit to this ecosystem is justified on regular basis.

As far as the end product is concerned I truly hope the results speak for themselves 🎉 and we will continue iterating and improving the feed. In case you have any feedback, [please let me know.](mailto:antony@functionalworks.com)