Library / Case Studies
Clustering Similar Stories Using LDA at Flipboard
There is more to a story than meets the eye, and some stories deserve to be presented from more than just one perspective. With Flipboard 4.0, we have released story roundups, a new feature that adds coverage from multiple sources to a story and provides you with a fuller picture of an event.
By Flipboard engineers · Flipboard · Added 2026-10-12
All content belongs to Flipboard engineers / Flipboard. We only link to it and give credit. Report a problem
Learn this case study
About 37 min left. Your work is saved as you go.
What you are about to study
Flipboard explains a real system. You should know the basics: caching, queues and replication.
Ideas you will meet
- Distributed Systems
- Consensus, time, failure and the fundamentals of scale-out.
- Machine Learning Systems
- Recommendations, ranking, feature stores and serving models at scale.
What we already know about this
Our own lessons on these ideas. Read them here before you start, so it makes sense.
Low-Level Design Practice · 10 minSocial feed (Instagram-style)Users, follows, posts and likes: a feed model with the Observer pattern for notifications and a strategy for ordering.Read here
The problem
Users follow each other, publish photo posts, like and comment, and see a home feed of posts from the accounts they follow. This lesson models the classes and rules. Scaling the feed (fan-out strategies) is covered in the news-feed lesson of the classic designs course.
Entities
100%Figure SDA-LLD-15-1 · Social feed classes · © forcsguy.com
Publishing and the feed
100%Figure SDA-LLD-15-2 · Publishing a post · © forcsguy.com
interface FeedStrategy { build(userId: string, limit: number): Post[] } const newestFirst: FeedStrategy = { build(userId, limit) { const followees = follows.acceptedFolloweesOf(userId); return posts.byAuthors(followees).filter(p => canView(userId, p)) .sort((a, b) => b.createdAt - a.createdAt).slice(0, limit); }, }; function canView(viewer: string, p: Post): boolean { // one place for visibility rules const author = users.get(p.authorId); return !author.isPrivate || author.id === viewer || follows.isAccepted(viewer, author.id); }Putting visibility in one function means the feed, profile and search all agree about who may see what.
Likes and comments
- A like is unique per
(user, post); enforce it with a uniqueness rule, not just a check, so double taps do not create two likes. - Keep a like count on the post for fast display and update it with each like or unlike, accepting that the count may briefly lag.
- Comments are ordered by time and can have a parent id for replies.
Design notes
- Pagination uses a cursor (the time or id of the last item) so new posts do not shift pages.
- Deleting a post must remove it from feeds and counts; a soft delete flag filtered at read time is the usual first step.
- Blocking and muting are visibility rules too.
- Extensions: stories with expiry, hashtags, tagging, search, and a ranking strategy that mixes recency with interest.
Real-world reading
Related reading
- Self-Ranking Search with Elasticsearch at WattpadWattpad engineers · WattpadCase Studies
- Monitoring Powers High Availability for LinkedIn FeedUSENIX engineers · USENIXCase Studies
- Search Federation Architecture at LinkedIn (2018)LinkedIn engineers · LinkedInCase Studies
- Scaling the Hadoop Distributed File System at LinkedInLinkedIn engineers · LinkedInCase Studies
Show 6 moreShow fewer
- Galene: Search Architecture of LinkedInLinkedIn engineers · LinkedInCase Studies
- Infrastructure to Run User Forecasts at SpotifySpotify engineers · SpotifyCase Studies
- Scalable User Privacy at SpotifySpotify engineers · SpotifyCase Studies
- Moving Food Feed from Redis to Cassandra at ZomatoZomato engineers · ZomatoCase Studies
- Clustering Similar Stories Using LDA at FlipboardFlipboard engineers · FlipboardCase Studies
- Data Orchestration Service at SpotifySpotify engineers · SpotifyCase Studies
- A like is unique per
Go deeper on this
A path through videos, articles, other case studies and code on the same ideas as Clustering Similar Stories Using LDA at Flipboard.
Warm upGet the vocabulary first.
Books · Free from the author
Concurrent and Distributed Systems (Cambridge lecture notes)
Eight lectures on time, broadcast, replication, consensus and transactions, with notes, slides and video. Free from the author under CC BY-SA.
University of CambridgeIntermediate
Books · Free from the author
Computer Networks: A Systems Approach
How networks are built and why: protocols, routing, congestion control and the internet's architecture. The authors publish it free online under CC BY 4.0.
Systems ApproachIntermediate
WatchHow others solve the same problem, on video.
Videos belong to their creators and play from YouTube. More on YouTube (opens in a new tab)
ReadEngineers explain it in their own words.
Blogs
Amazon Science
Technical deep-dives and perspectives from our scientists who are pushing boundaries across multiple scientific disciplines while solving real-world challenges. Explore how our teams combine research excellence, world...
AmazonIntermediate
Papers
Atom Smashing using Machine Learning at CERN
A real-world engineering write-up from CERN on distributed Machine Learning.
CERNIntermediate
See it in another companyThe same ideas, a different system.
Case Studies · Read here
Aroma: Using ML for Code Recommendation at Facebook
Thousands of engineers write the code to create our apps, which serve billions of people worldwide. This is no trivial task—our services have grown so diverse and complex that the codebase contains…
FacebookIntermediate
Case Studies · Read here
Concourse: Generating Personalized Content Notifications in Near-Real-Time at LinkedIn
Social media are computer-mediated platforms that facilitate creation and sharing of information, ideas, career interests, and other forms of expression via virtual communities and networks. In the last few years, not...
LinkedInIntermediate
Read the codeSee how it looks when it is real.
GitHub
Engineering Blogs
A huge directory of company engineering blogs to learn from real production systems.
kilimchoiIntermediate
GitHub
Awesome Scalability
Curated reading list of articles on the architecture of scalable, reliable systems.
binhnguyennusIntermediate
Keep learning
Loading community…