• Home
  • Blog
  • Projects
  • Bookshelf
  • About
← Back to all posts

Project Deep Dive: Tails

Published ....
Last modified ....

Share this post on BlueskySee discussion on Bluesky


I took about a week and a half off of work starting just before Christmas and ending right after New Years, I usually use this time to dig into a meaty project (sometimes related to this blog) and this year was no exception!

I had a few other projects in mind coming into this break but didn't feel too motivated to work on them. Instead I took the break slow, mainly focusing on my own working process (revamping my Notion setup) and also getting some reading in.

However, about halfway into my time off, I found an itch that I just had to scratch.

My dad and I share new cocktail recipes back and forth fairly often[1]Jump to footnote, usually in the form of TikTok clips. We've also been selecting usually a single (or a couple) specific cocktails that we want to make for the holidays.

However, we always ask the same questions:

What ingredients do we need for that one cocktail you wanted to make?

What was the recipe for that special cocktail again?

This year also, we made one of our favorites from last year (The Polar Empress) for my grandparents as well, and the next day my Grandma wanted to get the recipe for the drink.

Since she had asked about it, and since both of the above questions are common enough, I felt like it'd be interesting to build a quick and dirty web app to store cocktail recipes that we can then refer to later.

[2]Jump to footnote

And so, I started hacking on Tails.

🚧 Be warned, there's still a ton of things I need to get properly setup with this version of the service, but feel free to mess around and report any bugs here. 🚧

What is Tails?

Tails is a very basic

CRUD

[3]Jump to footnote

web app for saving and sharing cocktail recipes. That's it at the moment, no social features, no fancy whiz-bang features, just saving recipes!

It has a very basic version of auth/user accounts at the moment, allows you to add a recipe (with a title, description, steps, and ingredients), and also supports sharing those recipes with universal links (viewable to those without an account on Tails).

How does it work?

Similar to microfibre, Tails is built with two primary layers:

  • API
  • Frontend Web Client

The API is built on Cloudflare Workers (using Cloudflare D1 as the storage solution, honojs to handle routing, and lucia for auth), and the frontend web client is built with Next.js and deployed to Vercel.

The client interactions are all for the most part plain old forms using React Server Components and Server Actions. The Next.js server then interacts with the API hosted on Cloudflare.

The code is fully open source and available here: hamlim/tails, feel free to peruse the source and open issues for questions/comments/contributions.

If you read my microfibre deep dive, this tech stack probably sounds pretty familiar! I've been really enjoying Cloudflare's platform offerings, and I'm particularly interested in exploring Cloudflare R2 storage soon as well!

The Future

There's still a ton of things I want to build into the service, the first of which might be building up user profiles a bit more (so you can see who shared what cocktails) - however I don't think there's that much future for a social aspect built into the site!

Footnotes:

↩Back to reference Ok ok, it's usually me sending him cocktail recipes, but still

↩Back to reference

Now I know you're saying "but matt, there's a dozen such services out there for this use case, why build yet another one?" and to that I say - because I wanted to!

↩Back to reference

At the moment, it doesn't even support updating or deleting recipes! I'll have to add that in the future!


Tags:

Project Deep DiveProjectsWeb DevelopmentCloudflareNext.js

Loading...

Related Posts

Project Deep Dive

Project Deep Dive: Microfibre

....

A deep dive into one of my recent side projects; microfibre - a minimal text posting application

Projects

Hohoro

....

A quick introduction to my new side project, hohoro. An incremental JS/TS library build tool!

The Library-Docs Monorepo Template

....

A monorepo template for managing a library and documentation together.

Building Better Beacon

....

How we solved an almost show-stopping production bug, and how you can avoid it in your own projects.

Project Deep Dive: Microfibre

....

A deep dive into one of my recent side projects; microfibre - a minimal text posting application

Web Development

Website Redesign v11

....

I've once again updated my personal website, this time powered by my own RSC framework and a custom CMS solution as well!

Onboarding Your New AI Teammate

....

Are we reinventing the wheel when it comes to onboarding new AI agents to a codebase, when we already have primitives available for onboarding humans?

Quick Tip - Theme Aware Images

....

Cloudflare

Tip: Secrets for Cloudflare Workers

....

Configuring Cloudflare Domains with Vercel

....

I've started to use Cloudflare to manage my domains for several side projects, have had to jump through the same hooks multiple times that I figured I should document them here!

Project Deep Dive: Microfibre

....

A deep dive into one of my recent side projects; microfibre - a minimal text posting application

Next.js

Server Side Rendering Compatible CSS Theming

....

A quick tip to implementing CSS theming that's compatible with Server Side Rendered applications!

On File-System Routing Conventions

....

Some rough thoughts on building a file-system routing based web application

The Bookkeeping Pattern

....

A quick look at a small but powerful pattern I've been leveraging as of late!

Have you ever found the need to change the image you render on a web page based on the current preferred color scheme of your theme?

Async Class Creation In JavaScript

....

Have you ever wanted to create a class in JavaScript or TypeScript but also have the initialization be async? Here's a quick tip on a pattern that I've used in the past!

Website Redesign v10

....

I recently launched a rewrite and redesign of this personal website, I figured I'd talk a bit about the changes and new features that I added along the way!

Server Side Rendering Compatible CSS Theming

....

A quick tip to implementing CSS theming that's compatible with Server Side Rendered applications!

Podcasting By Hand

....

A brief overview on how we launched The Bikeshed Podcast, including a deep dive in our recording and distribution workflows!

Quick Tip - Specific Local Module Declarations

....

A quick tip outlining how to provide specific TypeScript type definitions for a local module!

On File-System Routing Conventions

....

Some rough thoughts on building a file-system routing based web application

You're Building Software Wrong

....

Slicing software: why vertical is better than horizontal.

Single File Web Apps

....

What if you could author an entire web application in a single file?

Resetting Controlled Components in Forms

....

A quick way to handle resetting internal state in components when a parent form is submitted!

A Quick Look at Import Maps

....

A brief look at Import Maps and package.json#imports to support isomorphic JavaScript applications!

Recommended Tech Talks

....

A collection of tech talks that I regularly re-watch and also recommend to everyone!

Request for a (minimal) RSC Framework

....

Some features and functionality that I'd like within a React Server Component compatible framework.

Bluesky Tips and Tools

....

A (running) collection of Bluesky tips, tools, packages, and other misc things!

The Bookkeeping Pattern

....

A quick look at a small but powerful pattern I've been leveraging as of late!

TSLite

....

A proposal for a minimal variant of TypeScript!

Monorepo Tips and Tricks

....

Sharing a few core recommendations when working within monorepos to make your life easier!

Next.js with Deno v2

....

This is a quick post noting that Next.js should now work with Deno v2!

Don't Break the Implicit Prop Contract

....

React components have a fundamental contract that is often unstated in their implementation, and you should know about it!

A Better useSSR Implementation

....

Replace that old useState and useEffect combo for a new and better option!

My Current Dev Setup

....

A quick look at the applications and tools that I (generally) use day to day for web development!

Abstract Your API

....

Proposing a solution for sharing core "business" logic across services!

Tip: Request and Response Headers

....

There's a common gotcha when creating Web Request and Response instances with Headers!

Using Feature Toggles to De-risk Refactors

....

Feature toggles are often underused by most software development teams, and yet offer so much value during not only feature development but also refactors

Hohoro

....

A quick introduction to my new side project, hohoro. An incremental JS/TS library build tool!

Custom Favicon Recipes

....

Two neat tricks for enhancing your site's favicon!

Corporate Sponsored OSS

....

The various risks and pitfalls of open source software run by corporations.

The Library-Docs Monorepo Template

....

A monorepo template for managing a library and documentation together.

Building Better Beacon

....

How we solved an almost show-stopping production bug, and how you can avoid it in your own projects.

Churn Anxiety

....

When did semver major changes become so scary?

Service Monitors and Observability

....

Leveraging service monitors properly to improve service observability.

On Adopting CSS-in-JS

....

A brief recap of how Wayfair changed it's CSS approach not once but twice in the span of 5 years!

Project Deep Dive: Microfibre

....

A deep dive into one of my recent side projects; microfibre - a minimal text posting application

Pair Programming

....

Pair programming can be good sometimes - but not all the time

Suspense Plus GraphQL

....

A few thoughts on using Suspense with GraphQL to optimize application data loading

You've Launched, Now What?

....

A few thoughts on what to do after you launch a new project

Taking a Break

....

A few quick thoughts on burn out and taking a break

Managing Complex UI Component State

....

A few thoughts on managing complex UI component state within React

Understanding React 16.3 Updates

....

A quick overview of the new lifecycle methods introduced in React 16.3

CSS in JS

....

A few thoughts and patterns for using styled-jsx or other CSS-in-JS solutions

Redesign v6

....

A few thoughts on the redesign of my personal site, adopting Next.js and deploying via Now

JavaScript Weirdness

....

A few weird things about JavaScript

Calendar

....

Building a calendar web application

Next.js with Deno v2

....

This is a quick post noting that Next.js should now work with Deno v2!

Using Feature Toggles to De-risk Refactors

....

Feature toggles are often underused by most software development teams, and yet offer so much value during not only feature development but also refactors

Funport: True Dynamic Imports in webpack

....

webpack, and tools built on it like Next.js, don't support true dynamic imports, but I found a way to trick the system!

Project Deep Dive: Microfibre

....

A deep dive into one of my recent side projects; microfibre - a minimal text posting application

Redesign v6

....

A few thoughts on the redesign of my personal site, adopting Next.js and deploying via Now