AddThisFeature

Quiet Hours

Hold non-urgent notifications until the user actually wants to hear from you.

moderate Engagement

What it adds

A per-user window during which outbound notifications are suppressed, with an explicit rule for what happens to anything that arrives inside it.

What your agent is told to do

5
  1. 1

    Extend the existing notification pipeline with a suppression check at send time. Do not build a second notification system.

  2. 2

    Let the user set a start and end time and store the time zone the window was defined in.

  3. 3

    Decide per notification type whether it is deferred to the end of the window, dropped entirely, or allowed through as urgent — and record that decision in the notification's definition, not in scattered call sites.

  4. 4

    Deliver deferred messages as a single digest when the window ends, not as a burst of twenty separate pushes.

  5. 5

    Do NOT let quiet hours suppress security messages — password changes, new sign-ins, billing failures. A user who cannot be reached about account compromise is worse off than one who was woken up.

Edge cases it handles

6
  • Evaluate the window against the user's current time zone, not the server's and not the one they signed up in.
  • A window that crosses midnight (22:00 to 07:00) is the common case, not the exception. Handle it first.
  • Daylight-saving shifts can make a window an hour shorter or longer, and can make a deferred send time occur twice or not at all.
  • A deferred notification about a record that was since deleted or resolved must be dropped, not delivered stale.
  • Ten deferred notifications about the same record must collapse into one on release.
  • Turning quiet hours off mid-window should release the queue immediately, not wait for the original end time.

Definition of done

8
  • Non-urgent notifications sent inside the window are not delivered during it.
  • Windows crossing midnight behave correctly.
  • The window is evaluated in the user's current time zone and survives daylight-saving changes.
  • Each notification type has a declared behaviour: defer, drop, or bypass.
  • Deferred messages arrive as one digest, with stale entries removed.
  • Security and billing notifications always bypass the window.
  • The feature matches the existing design system.
  • No existing functionality is broken.

Related features

How it works

  1. 1

    Copy the link

    Grab the Markdown instruction URL for this feature.

  2. 2

    Give it to your AI

    Paste it into Claude Code, Cursor, v0, Lovable — whatever you build with.

  3. 3

    It inspects, then implements

    Your agent reads your existing app first, then adds the feature to fit it.

Works with your stack

These instructions are written to adapt. They tell the agent to detect your framework, match your existing design system, and reuse what you already have — rather than assuming a particular stack.

Need it tighter than that? Customize the feature and tell it exactly what you're running.