codeforpdx / codeforpdx/tenantfirstaid

Feature UX (Chat +Letter)

Open
#238 0 comments 0 reactions 2 assignees View on GitHub

@leekahung is already working on this.

Since Dec 10, 2025.

UX design
Dominant language
Python
Stars
13
Forks
21
Avg merge
6d 7h
Merged PRs (30d)
3

Description

OVERVIEW

This issue improves the core interaction patterns of the AI Chat and Letter Generator across all entry points (landing, menu, and in-chat transitions). The current experience allows users to reach letters through both pathways and can unintentionally confuse the users. We will define cleaner distinctions between Chat and Letter, introduce stronger guidance for letter creation, and ensure users can confidently draft, finalize, and save/export letters. This ensures feature parity and clarity regardless of how users enter the tools.

Scope

Chat/Letter behavior, transitions, templates, and export experience.

ACTION ITEMS

  • Letter Flow Refinements
    • define whether chat is embedded helper with clear guidance/pop-ups, or used only for content refinement at the certain stage of the process and everything else is accommodated with type forms.
    • Potential Flow before AI Chat is embedded
      • Create Letter Welcome page (Disclaimer/Instructions/What to Expect)
      • Add Eligibility step (which state are they from) if needed
      • Add the same Qs like city, type of housing, and issue (if based on their issue letter cannot be generated, we can have a pop-up about it. Alternatively, we can ask about city, type of housing, and then type of letter they would like to write and provide available options (e.g., requesting repairs, disputing illegal landlord entry, return of security deposit, lease viollation, illegal fee) (We need to discuss more what is the easiest approach)
      • Generate Letter template based on the type off letter or housing issue (depending on the logic we choose)
      • Use AI chat bot prompts to clarify content and modify the letter
      • Create FINALIZE button if they want to fill personal information and download, add privacy disclaimer: info won’t be saved
      • Create EXIT and give option to copy and paste before if they don't want to go forward with the next step
      • If user choose FINALIZE, they will see a form to add personal info on the next screen
        • After filling the form with personal info, confirm users will be able to preview and download on next screen.
        • Preview of the letter and export options (Word, PDF, txt)

LINKED ISSUES/DOCUMENTS:

  • #228

Contributor guide

No contributing guide indexed for this repository

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

Assessment

This issue has not been assessed yet.

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.