DEV Community

anup s
anup s

Posted on

Flow — Experience the Library, Through Luminary

This is the experience I want reading with Luminary to feel like — not a feature list, but a day in the life: a trip to the library. The story runs on top; the italic line under each screenshot says what you are looking at.

Jump to: Determination · The Road Ahead · The Scout · Dig Deep · Recall · Sense of Satisfaction · What's new

Determination

You've been procrastinating about reading. Your super-talented friend inspires you. Today, you decide to take up a membership at the state library.

Some of the best things in life are free.

Your membership is a download: the macOS bundle, dragged into Applications. You've taken the first step toward reading. You set a reading time and put together a timetable.

Installing Luminary: the app being copied into the Applications folder|medium

Installing.

The Road Ahead

It's time to head to the library. You open the app, and your friend is right there beside you as you follow the green, twisting pathway across the park.

Luminary launch screen reading Opening your library, above a line about how learning works|medium

The launch screen.

You're greeted by huge wooden doors opening onto a magnificent campus. As you step in, a quote carved into a stone wall catches your eye.

The unexamined life is not worth living.
— Socrates

Luminary home screen with a Socrates quote, the daily flashcard review and books to pick back up|medium

The home screen.

You linger on the thought, momentarily lost in it, until a message on your phone breaks the spell — your partner, asking you to meet for lunch. You reply, put your phone on silent, and make a mental note to set a timer. Looking up, you take in the sheer abundance of books before you. You don't know where to start. You settle on a genre, climb the winding stairs to level two, and head toward the section that interests you.

The Scout

The Luminary Library page: tiles for a tech book, YouTube videos and a note, each with flashcard counts and mastery|large

The Library.

You pick a book that catches your eye, a tutorial on retrieval and memory, and settle at a corner desk — ambient window light, a view toward the fountain. You open it, glance at the title, skim the preface and the contents to get a feel for what it's about.

The Luminary reader: contents on the left, the book in the middle, and an Insights panel with Key Points on the right|large

The reader: Contents on the left, Insights (your preface) on the right.

Before you begin, you check your watch and set a reminder for lunch with your partner. (Luminary has a Pomodoro focus timer at the top of the screen.)

As you settle in, you lay out your reference cards and sip some water. The smell of the paper draws you in (paper mode, in the Universal Reader). You grab your notebook and pen, and start writing down your understanding, sketching things out to cement what you've learned.

A note written beside the book: a hand-drawn diagram of query, data store and augmented response, plus a recall versus precision table|medium

Notes, written beside the page.

As you read on, you slip into a focused rhythm.

The reader with the side panels closed, showing a section on the bi-encoder architecture|large

Focused reading, side panels closed.

Dig Deep

A particular topic still isn't clicking, even after re-reading. You turn to your expert friend and select the passage, and he elaborates in plain language.

A selected paragraph about HNSW with an Explain button, and a plain-language explanation beside it|large

Select text, then Explain.

You discuss it further; your friend offers an analogy, and when you push with a deeper question, he points you back to the book itself.

The Ask AI panel answering the question How is HNSW implemented, beside the page it came from|large

Ask AI, beside the page.

Recall

Your reminder nudges you softly. (The focus timer ends.) It's about time to leave and meet your waiting partner. You let your friend know it's time to go and gather your things — glad you nearly made it to the end of the chapter. Your friend checks in: how well did you really understand the topic? Feeling fairly confident, you ask to be quizzed. On the way to the restaurant, the questions come — some easy, some that make you think. Before each answer is revealed, you're asked to predict how you'll do. Your neurons start firing, forging stronger connections.

The Map: a graph of the concepts found across the library, linked where they appear together|medium

The Map.

Then comes the honest part: what you predicted, next to how you actually did. It isn't always flattering — fairly confident, less right than you thought — but now you know exactly where you stand.

The Progress page, with prediction calibration, streak, level and XP|medium

Progress.

Sense of Satisfaction

Caught up in the discussion, you barely notice arriving — until you spot your partner smiling in the distance. She greets you both, but your friend excuses himself and says goodbye. (The laptop closes, and Luminary with it. Your friend was Luminary all along.)

As you settle in with your partner for lunch, you have a relaxed, enjoyable meal — laughing, talking, sharing. Just as you're about to pay the bill, your partner notices a card fallen a couple of feet from the table. She picks it up and hands it to you with a smile. You take a look, and a similar smile spreads across your face.

The Luminary About card: version 0.12.11, public mode, and a note that your documents, notes and review history stay on your machine|small

It was never a lending library. It is all yours, in one folder.

That's the flow I'm building toward — not another chat window bolted onto your files, but a library experience, built around retrieval you can actually trust, grounded in the books you brought with you. This release gets us a step closer.

What's new since my last post

My last post was at 0.8.28; this walk is 0.13.1.

  • A library that looks like one: covers and thumbnails, and filters by form, domain and register.
  • One docked panel beside the page for notes, chat, Explain, cards and teach-back, instead of five dialogs.
  • Citations open on the passage, and every click works, not only the first.
  • Fast or private, with a receipt for every answer: engine, latency, cost, and what left your machine.
  • Practice hides the answer until you commit; teach-back is scored and can be retried.
  • Dictation, O'Reilly URL ingest and EPUB figures.

The full list is in the changelog.

Try it

Download for Mac Silicon

Source on GitHub · The two-minute tour · Back to the top

Top comments (0)