Welcome to breifd

What is breifd?

breifd is a free AI-powered daily newsletter. Pick the topics you care about and every morning, a personalized briefing lands in your inbox — written like real journalism, not bullet points.

Getting Started

You'll be up and running in under 3 minutes.

Dashboard

The dashboard at /dashboard is your home base — your briefing, a public explore feed, and your pinned stories all in one view.

Header bar

Profile dropdown

Your Briefing — three states

Explore All Briefs

• Date navigation — < and > arrows browse other days. Cannot go into the future.
• Archive search — searches title, topic, category, and content. 250ms debounce.
• Category filter pills — filter the grid by category (Tech, Business, World…).
• Hover to reveal — pin (📌) and share (🔗) icons appear on card hover.
• Fallback — if today's briefs haven't been generated yet, shows the most recent day with content — but only if that day is within the last 2 days. Beyond that, the feed shows empty to signal a generation failure rather than serving stale content.

Testimonial prompt

After 3+ days as a user, a banner appears on the Dashboard asking if you'd like to leave a testimonial. Note: it's your submitted testimonial text that gets shown on the breifd.it homepage — not the banner itself. Dismiss with ✕ (stored in localStorage, won't reappear).

Reading a Brief

The brief detail page at /brief/:id is where you read each story. An orange reading progress bar runs under the header and fills as you scroll.

Header tools

Feedback

Below the article: 👍 / 👎. After voting, a detail panel opens with tag chips and a free-text box. One time per brief.

Sources & Follow This Story

Each source is listed at the bottom with a clickable link and a political bias label for known outlets. Related briefs on the same topic appear in a "Follow This Story" section below.

My Topics

Open the topic drawer by clicking My Topics in the header or via the profile dropdown. Changes save instantly and apply to tomorrow's briefing.

Topic hierarchy

Group → Category → Subtopic

Example:
Technology
  └─ Artificial Intelligence
       └─ ChatGPT & LLMs
       └─ AI Ethics
       └─ Generative AI

You subscribe at the subtopic level. Group and category are navigation only.

Using the drawer

1. Click a Group to expand it
2. Click a Category to expand its subtopics
3. Toggle individual subtopics, or use Select all / Deselect all
4. Use the search box to filter — all matching groups expand automatically

Past Briefings

Available at /briefings — or Profile → Past Briefings. Shows all your personal briefings, the ones sent to your email.

• Search — filter by topic name, date, or content keywords
• Expand a row — click any card to expand a content preview
• Read full — opens the brief detail page
• Delete — permanently removes the briefing. Cannot be undone.

Settings

Accessible at /settings. Four sections: Profile, Delivery Preferences, Change Email, Change Password.

Profile

• First name — used in the dashboard greeting
• Profile picture — click the camera icon to upload. Max 5 MB, any image format. "Remove picture" to delete.

Delivery Preferences

Change Email

Enter and confirm your new email, then click Update Email. A confirmation link goes to the new address — the change only takes effect after clicking it.

Change Password

Requires your current password plus a new one (minimum 6 characters). The app re-authenticates before applying the change.

Shared Briefs

Any brief can be shared via a link that works without logging in at breifd.it/shared/[id].

How to share

• From the dashboard — hover a card, click the 🔗 icon
• From brief detail — click the 🔗 icon in the header

The shared brief page

Recipients see the full article plus a "Get briefs like this every morning. It's free." signup CTA — no login required.

Keyboard Shortcuts

Shortcuts are active on the Dashboard when focus is not in a text input. Press ? anytime to see the in-app overlay.

Focus Mode

Focus Mode swaps the full article for a concise 5-sentence AI summary — perfect for skimming on busy mornings.

• Toggle via the 🎯 icon in the brief detail header
• Summary generated on-demand by the explain-story edge function
• State persists in localStorage — returning to the tab keeps you in Focus Mode
• Click "Read full brief →" at the bottom to exit and see the full article

Listen (Audio)

Every brief can be read aloud using ElevenLabs TTS. Available via the 🔊 icon on the brief detail page.

Pinning Stories

Pin up to 3 stories to keep them at the top of your dashboard for quick access. Pins sync to your account and persist across devices.

• From dashboard — hover a card, click the 📌 icon (top-right of card)
• From brief detail — click the 📌 icon in the header
• Via keyboard — press S on the focused card

Mood Check-in

Once per day, a dialog appears ~800ms after the dashboard briefing loads asking "How are you feeling today?"

The date is saved in localStorage the moment the dialog opens — so closing without selecting still counts as today's check-in. The dialog won't appear again until the next day. When Stressed or Low is selected, the toast reads: "Focus mode enabled — showing a calmer briefing today." 🧘

Source Bias Labels

When a source is from a recognized news outlet, a political lean label appears next to it in the sources section of a brief.

Recognized outlets include: NYT (Center-Left), BBC (Center), Reuters (Center), WSJ (Center-Right), Fox News (Right), Vox (Left), NPR (Center-Left), Bloomberg (Center), AP News (Center), and 40+ more (53 total). Unknown outlets show no label.

Referrals

Every account has a unique referral code. Share your link and your friend gets 10% off their first 3 months when paid plans launch.

• Access via: Profile dropdown → Share breifd
• Copies breifd.it/signup?ref=[your-code] to clipboard
• Your referral code is also embedded in brief share links automatically
• If your code isn't available yet: "Referral code not available yet"

Dashboard Tutorial

A 4-step guided tour runs automatically for first-time users. Reopen it via the ❓ button (desktop) or Profile → Show tutorial (mobile).

Click anywhere on the backdrop to skip. Press Esc to close. "Got it" on step 4 marks the tutorial complete so it won't auto-show again.

Known Issues

A few behaviors to be aware of — some are known bugs, some are working as designed.

FAQ

Common questions, answered.

Pages & Routes

Every URL in the app and whether it requires authentication.