📝

Turn What You Read Into Action with Read & Act

A practical, step‑by‑step guide to using Read & Act to turn highlights, quotes, and ideas into small, concrete actions you actually follow through on.

Turn What You Read Into Action: A Practical Guide to Using “Read & Act”

If you’ve ever highlighted a great quote, felt inspired for five seconds, and then… did nothing, this app is for you.

Read & Act helps you turn ideas from books, articles, and your own thoughts into small, concrete actions. It keeps everything local in your browser, and gives you a simple rhythm: capture → convert → act → review.

This guide walks you through the app step by step.

1. Getting Started

Open the app (hosted or local) and you’ll see a clean layout with:

  • A sidebar on desktop with navigation and a daily tip.
  • A bottom nav bar on mobile.
  • A language toggle (EN / 中) in the top-right on desktop, or in the mobile header.

The main navigation has five sections:

  1. Inspiration – Home view with today’s suggested action and recent notes.
  2. My Notes – Your full note library and AI-generated actions.
  3. Knowledge Map – Interactive graph of sources and tags.
  4. Growth – Weekly progress and theme distribution.
  5. Privacy – How your data is stored plus export.

You’ll also see a prominent “Add note” button (top-right on desktop, floating bottom-right button on mobile).

2. Capture Your First Note

Click “Add note” to open the note modal. You’ll see four fields:

  • Source (optional)
    Example: Atomic Habits, Blog post on deep work, or leave blank and just capture the idea.
  • Author (optional)
    Example: James Clear.
  • Excerpt / Idea (required)
    The core quote, passage, or your own thought you want to act on.
  • Tags (comma separated)
    Example: Habits, Focus, Health.

How the app treats the “Source”

You don’t have to fill in the Source; if you leave it blank, the app will:

  • Look at your excerpt,
  • Take a short, meaningful slice of it,
  • Use that as the source label (e.g., “The unexamined life…” → The unexamined life is not...).

This keeps your library tidy even if you’re capturing quick thoughts.

Save the note

Once you’re done:

  1. Make sure the Excerpt / Idea field is filled.
  2. Click “Save note”.

The note is now stored in your browser (IndexedDB) and will show up in:

  • Inspiration → Recent inputs (top of the home screen).
  • My Notes – your main library.
  • Knowledge Map – once it has tags.

3. Turn Notes Into Tiny Actions

The magic of Read & Act is in converting notes into small, doable steps.

Go to “My Notes”. For each note you’ll see:

  • The source and author.
  • The excerpt in a quote block.
  • Any tags.
  • A status: Waiting to convert or Actions generated.

On notes that haven’t been processed yet:

  1. Click “Generate actions”.
  2. The button will change to AI thinking... while your Cloudflare Worker + AI provider generates ideas.
  3. When finished, you’ll see:
    • A badge: “Actions generated”.
    • A list of 1–3 micro-actions beneath the note.

Each action includes:

  • Title – starts with a verb.
  • Description – concrete guidance for what to do.
  • Duration – e.g., 5 min, 10 min.
  • Type – Reflection, Interaction, or Observation.

You can:

  • Click the small circle button next to an action to mark it done (and unmark if you change your mind).
  • See the action’s type and duration displayed underneath.

If something goes wrong with the AI call, you’ll see a friendly error message at the top of My Notes and can try again later.

4. Use the Daily “Inspiration” View

The Inspiration tab is your home base. It’s designed for quick, daily check-ins.

You’ll find:

  • A date badge at the top (localized to your language).
  • A greeting like “Hello, reader.” / “你好，思考者。”.
  • A main card that shows:

Today’s suggested action

If you have any incomplete actions, the app will:

  • Pick one and show it as “Today’s pick”.
  • Display its title, description, and duration.
  • Offer a big “Mark done” button.

When you click “Mark done”:

  • The action is marked as completed.
  • It contributes to your growth statistics.
  • It disappears from the “pending” pool so tomorrow’s suggestion can rotate.

When you have no actions

If there are no pending actions, the home card will:

  • Celebrate that you’re “All done!” if you’ve generated actions before.
  • Or encourage you to add your first note.

You also get:

  • “Add a note” button – opens the capture modal.
  • “Go to notes” / “View all” – jumps to your full library.

Below the main card, you’ll see Recent inputs: a compact grid of your latest notes (source, date, excerpt, tags) for quick review.

5. Organize and Filter Your Notes

Back in My Notes, you have powerful tools for finding the right ideas:

  • Use the search bar at the top to filter by keywords from source, author, excerpt, or tags.
  • It updates in real time as you type.

Filter by tag

  • Use the tag pills or dropdown to narrow down notes by theme, like Habits, Focus, or Relationships.

Filter by status

  • Show only notes that:
    • Are waiting to convert (no actions yet).
    • Already have generated actions.

These small filters make it easy to decide:

  • “What should I convert next?”
  • “Which notes still need actions?”

6. Explore the Knowledge Map

The Knowledge Map view gives you a visual graph of your notes and tags.

  • Each source becomes a node.
  • Each tag also becomes a node.
  • The app draws connections between them.

When the map is empty

If you’re just starting:

  • You’ll see an empty state encouraging you to add notes and tags.
  • It offers an “Add a note” button.

When the map has data

  • You can click and drag nodes to explore clusters.
  • Use the map to see:
    • Which concepts are central (tags that appear across many sources).
    • Which books or sources cluster around similar ideas.
  • On mobile, you can still pan and explore; the layout is responsive.

This works best if you use consistent tags, e.g.:

  • Habits, Focus, Relationships, Health, Career.

7. Track Your Growth

The Growth tab summarizes your progress.

Stats cards

At the top, you’ll see four cards:

  1. Total notes – how many notes you’ve saved.
  2. Completed – how many actions you’ve marked as done.
  3. Completion rate – percentage of actions completed.
  4. Focus area – the top tag across your notes (or a fallback if you have no tags yet).

These give you a quick snapshot of how actively you’re turning ideas into behavior.

Weekly action trend

The left chart is a bar chart showing:

  • The last 7 days, Monday-first.
  • How many actions you completed each day.
  • Today’s bar highlighted in a contrasting color.

Use this to see whether you’re consistently acting on your notes during the week.

Knowledge theme distribution

The right chart is a pie chart of your top 5 tags:

  • Each slice corresponds to a tag.
  • A small legend lists the top few themes and their colors.

This is useful for answering questions like:

  • “Am I mostly reading about productivity?”
  • “Am I balancing reflection, health, and relationships?”
  • “What topics dominate my attention lately?”

If there isn’t enough data yet, you’ll see a simple empty state encouraging you to generate more actions.

8. Privacy, Storage, and Export

The Privacy tab explains how your data is handled, in both English and Chinese.

Key points:

  • Notes and actions are stored locally in your browser’s IndexedDB.
  • Locale preference is stored in localStorage so the app remembers your language.
  • A service worker only caches static assets for performance; no trackers are included.
  • AI calls go to your configured Cloudflare Worker endpoint (not third-party scripts in the page).

Export your data

You can download your data as a JSON backup:

  1. Go to the Privacy tab.
  2. Find the “Export data” card.
  3. Click “Export JSON”.

The app will:

  • Generate a JSON file containing:
    • App version
    • Export timestamp
    • All notes and their generated actions
  • Trigger a download with a filename like:
    • read-and-act-notes-YYYY-MM-DD.json

You can store this in your own backups, use it for analysis, or import it into other tools manually.

9. Language and Bilingual Use

Read & Act is built for English and Simplified Chinese.

  • Use the language toggle (EN / 中) to switch.
  • The UI copy, labels, and privacy text switch accordingly.
  • The AI is instructed to answer in the correct language:
    • In Chinese: short, clear, everyday Chinese.
    • In English: concise, practical phrasing.

Your language preference is remembered on the same browser, so you don’t have to toggle every time.

10. Practical Workflows to Try

Here are some simple patterns to get the most out of the app:

  • Daily reading loop

    • Capture 1–3 quotes or insights.
    • Tag them with 2–3 themes.
    • Generate actions for at least one note.
    • Use Inspiration to execute at least one action.

  • Weekly review

    • Open Growth and look at:
      • Completion rate.
      • Top tags.
      • Weekly action trend.
    • Decide one area to lean into more next week.

  • Building a topic map

    • For a new learning project (e.g., “Public speaking”):
      • Tag all relevant notes with Public speaking.
      • Check the Knowledge Map to see how this connects with other tags like Confidence, Storytelling, etc.

By combining simple capture, AI-generated micro-actions, and visual feedback, Read & Act gives you a lightweight but powerful system for turning what you read into how you live.