Skip to content
Bookmarks Docs

User Guide

User Guide

Section titled “User Guide”

This guide is for readers and club members using the Bookmarks app on web or mobile.

1. Sign In Or Create An Account

Section titled “1. Sign In Or Create An Account”

When you open the app, you can:

  • Log in with your existing email and password.
  • Create a new account from Create account.
  • Request a reset link from Forgot password.
  • Confirm a reset with Reset password using the token from email.

If sign-in fails, verify:

  • You are using the same email that was registered.
  • Your account is verified (if your environment requires email verification).
  • Your password meets complexity requirements when resetting.

2. Join Or Create A Club

Section titled “2. Join Or Create A Club”

After login, the Clubs screen shows available clubs.

  • Use Create Club to start a new club.
  • Use Join on an existing club when available.
  • Open a club to view books, notes, meetings, and members.

3. Read And Post Notes

Section titled “3. Read And Post Notes”

Inside a club:

  • Browse notes by section type: chapter, character, or event.
  • Create new notes in the appropriate section.
  • Reply to comments and react to notes.
  • Respect spoiler level settings when posting.

Realtime updates are pushed to active clients, so you may see new comments/reactions without manual refresh.

4. Manage Meetings And RSVPs

Section titled “4. Manage Meetings And RSVPs”

Meetings support planning and attendance tracking:

  • Create meetings with title, schedule, location, and details.
  • RSVP as Going, Maybe, or Can't.
  • Review who selected each RSVP state.
  • Use calendar export links when provided by your club workflow.

5. Profile, Roles, And Theme

Section titled “5. Profile, Roles, And Theme”

From profile/settings:

  • Update display name and optional profile fields.
  • View your club role (member/admin) per club.
  • Change app theme; preference is saved to your account.
  • Use Log out to end the current session.

6. Common Issues

Section titled “6. Common Issues”

API Unreachable

Section titled “API Unreachable”

If the app cannot reach the API:

  • Confirm the API base URL is correct for your environment.
  • Confirm the worker is deployed and healthy (/health).

Unauthorized Errors

Section titled “Unauthorized Errors”

If requests return 401:

  • Log out and sign back in.
  • Ensure refresh flow is enabled in your environment.
  • Confirm auth-worker/service bindings are healthy in deployment.
Section titled “Reset Link Problems”

If password reset confirmation fails:

  • Ensure the token is complete and not expired.
  • Request a new reset link and retry.

PWA Installation

Section titled “PWA Installation”