memos/.github/ISSUE_TEMPLATE/bug_report.yml

name: Bug Report
description: Report reproducible behavior that is broken in the current version
type: Bug
body:
  - type: markdown
    attributes:
      value: |
        Thanks for reporting a bug. Please help maintainers reproduce it on current code.

        Before submitting:
        - Search [existing issues](https://github.com/usememos/memos/issues) to avoid duplicates.
        - Upgrade and retest with the [latest release](https://github.com/usememos/memos/releases/latest), current `main`, or the [demo site](https://demo.usememos.com/).
        - Use [Discussions](https://github.com/usememos/memos/discussions) for questions, setup help, or configuration troubleshooting.

        Maintainers normally fix bugs in current code and future releases, not older released versions.        

  - type: checkboxes
    id: pre-check
    attributes:
      label: Pre-submission Checklist
      options:
        - label: I have searched existing issues and confirmed this has not already been reported
          required: true
        - label: I have reproduced this bug on the latest Memos release, current `main`, or the demo site, or this report is specifically about upgrading to the latest release
          required: true
        - label: This is a bug report, not a question or configuration request
          required: true

  - type: dropdown
    id: area
    attributes:
      label: Affected Area
      description: Choose the main area where the bug appears.
      multiple: true
      options:
        - Web UI
        - API
        - Authentication / SSO
        - Database / migration
        - Resources / attachments
        - Search / filters
        - Markdown / editor
        - Deployment / startup
        - Other
    validations:
      required: true

  - type: dropdown
    id: reproduced-on
    attributes:
      label: Reproduced On
      description: Where did you confirm the issue still happens?
      options:
        - Latest release
        - Current main branch
        - Demo site
        - Upgrade to latest release
        - I cannot test the latest version
    validations:
      required: true

  - type: input
    id: version
    attributes:
      label: Memos Version Tested
      description: Report the exact version where you reproduced the bug. Use the version shown in **Settings > System**, the container image tag, the release binary version, or `memos --version`. Please do not write `latest` only.
      placeholder: "v0.29.x, ghcr.io/usememos/memos:v0.29.x, main@abcdef, or demo site"
    validations:
      required: true

  - type: input
    id: previous-version
    attributes:
      label: Previous Version
      description: If this happened after an upgrade, enter the version you upgraded from. Leave blank if not applicable.
      placeholder: "v0.28.x, unknown, or not applicable"

  - type: textarea
    id: environment
    attributes:
      label: Environment Details
      description: Include the deployment, database, client, and network details that apply.
      placeholder: |
        - Deployment: Docker / binary / source / demo site
        - Database: SQLite / PostgreSQL / MySQL
        - Browser: Firefox 126 on macOS 15
        - Server OS: Ubuntu 24.04
        - Reverse proxy: nginx / Caddy / Traefik / none
        - Related settings: SSO / SMTP / storage / webhooks / none        
    validations:
      required: true

  - type: dropdown
    id: frequency
    attributes:
      label: Reproduction Frequency
      description: How reliably can you reproduce this?
      options:
        - Always
        - Often
        - Sometimes
        - Once
        - Unknown
    validations:
      required: true

  - type: textarea
    id: reproduction-steps
    attributes:
      label: Steps to Reproduce
      description: Provide minimal, numbered steps that start from a clean page/session when possible.
      placeholder: |
        1. Open ...
        2. Click ...
        3. Enter ...
        4. Wait for ...
        5. See ...        
    validations:
      required: true

  - type: textarea
    id: current-behavior
    attributes:
      label: Current Behavior
      description: What happened? Include exact error messages, status codes, or visible UI state if available.
      placeholder: The application ...
    validations:
      required: true

  - type: textarea
    id: expected-behavior
    attributes:
      label: Expected Behavior
      description: What did you expect to happen instead?
      placeholder: I expected...
    validations:
      required: true

  - type: textarea
    id: regression
    attributes:
      label: Regression Information
      description: If this worked before, describe when it last worked and what changed before it broke.
      placeholder: |
        This last worked in ...
        It started after ...        

  - type: textarea
    id: logs
    attributes:
      label: Logs
      description: Paste relevant server logs, browser console output, or network errors. Remove secrets before submitting.
      render: shell
      placeholder: |
                Paste logs here.

  - type: textarea
    id: additional-context
    attributes:
      label: Additional Context
      description: Attach screenshots, screen recordings, sample data, exports, or links to related issues.
      placeholder: Drag and drop files here or add any extra context.