Why Telesink Uses a Text-First UI

/ X · Bluesky · Mastodon

When building Telesink — my open-source real-time event dashboard for monitoring signups, deployments, webhooks, errors, and everything your product is doing right now — I made a deliberate design decision: prioritize crystal-clear communication over visual decoration.

The result is a clean, mostly text-based interface that lets developers and product teams instantly understand what’s happening without any guesswork.

Telesink settings interface showing its text-first design

Why Most Interfaces Over-Rely on Icons

Modern dashboards are packed with icons. They look professional and save space, but while developing Telesink I realized they often create more friction than clarity — especially when you need to monitor live events in real time.

Icons do make sense in a few specific situations:

  • Multilingual products (quick visual affordances when language varies)
  • Space-constrained layouts (mobile views or dense multi-column feeds)
  • Repeated actions users learn quickly
  • Visual grouping of related tools
  • Instant status feedback (success, warning, loading)

Where Icons Fall Short in a Real-Time Dashboard

For the majority of Telesink’s interface, however, icons were not the right choice. Here’s why I moved away from them:

  • Many icons must be learned and are not universally understood
  • They’re often ambiguous without labels (the classic gear icon — Settings? Preferences? Admin?)
  • They slow down new users who just want to see their live events
  • They add visual noise that distracts from the actual data
  • They increase design, consistency, and maintenance overhead
  • Text is far more accessible for screen readers and easier to localize

Telesink’s Text-First Philosophy

That’s why Telesink ships with a predominantly text-based UI. This wasn’t a minimalist styling choice — it was a practical decision built around the needs of developers and teams who rely on real-time visibility.

The benefits are immediate:

  • Every action is instantly understandable
  • Zero guesswork when scanning live events
  • Much faster onboarding for new users
  • Significantly simpler to build, maintain, and improve over time

My Design Rule of Thumb for Telesink

Every UI element in Telesink now goes through the same two-question filter:

  • Would a first-time user understand this instantly?
  • Does the icon truly add clarity, or is it mostly decoration?

If it doesn’t pass both questions with a clear “yes”, I default to text. This simple rule has removed unnecessary clutter and forced every part of the interface to justify itself through better communication.

Even when I do use an icon, my process stays lightweight: I first search for a clean HTML entity, and only if that doesn’t work do I fall back to an emoji.

I also optimize Telesink for load speed and try to avoid any unnecessary fluff — every decision (text over icons, HTML entities over SVGs, minimal assets) is made with performance and simplicity in mind.

The outcome is a calm, direct, and highly functional dashboard — exactly what you need when you’re watching your product live.

Less decoration, more communication.

If you want a clean, fast, and clear real-time view of your product’s important events, try Telesink today. It’s available as a hosted service, and the full open-source version is free to self-host if you prefer.