Skip to content

Conversation

@httpdss
Copy link
Owner

@httpdss httpdss commented Oct 24, 2025

Overview

Improves the interactive variable prompting experience by displaying variable descriptions, contextual icons, and bold variable names for better user guidance.

Changes

Core Features

  • Variable Descriptions: Display description field (or help as fallback) when prompting users in interactive mode
  • Contextual Icons: Automatically select appropriate emojis based on variable names and types:
    • 🚀 Project/app names
    • 🌍 Environment/deployment variables
    • 🔌 Ports/network settings
    • 🗄️ Database configurations
    • ⚡ Boolean/toggle options
    • 🔐 Authentication/secrets
    • 🏷️ Versions/tags
    • 📁 Paths/directories
    • 🔧 General variables (default)
  • Bold Variable Names: Improve readability with ANSI bold formatting in terminal
  • Smart Formatting: Conditional display based on description presence (compact for no description, full for descriptions)

Implementation

  • Added _get_variable_icon() method in TemplateRenderer for icon selection logic
  • Enhanced prompt_for_missing_vars() to handle descriptions and formatting
  • Proper enum handling with options display

Documentation

  • Updated docs/template-variables.md with visual examples
  • Documented contextual icon selection
  • Noted description and help field support

Testing

  • Comprehensive test coverage for new formatting and icon logic
  • Tests for enum and non-enum variable prompts

Additional

  • Updated WARP.md with GitHub MCP issue management guidelines

Closes #116

- Add support for displaying variable descriptions in interactive prompts
- Support both 'description' and 'help' fields for backward compatibility
- Display descriptions only when available, maintaining clean prompts otherwise
- Add comprehensive tests for the new functionality
- Update documentation to explain the new feature

Closes #116
- Replace basic description display with clean Option 4 format
- Add contextual icons based on variable names and types
- Implement cleaner two-line format for variables with descriptions
- Maintain compact inline format for variables without descriptions
- Add comprehensive test coverage for icon selection logic
- Update documentation with new formatting examples

Icons included:
🚀 Project/app names | 🌍 Environment vars | 🔌 Network/ports
🗄️ Database configs | ⚡ Boolean toggles | 🔐 Auth/secrets
🏷️ Versions/tags | 📁 Paths/directories | 🔧 General vars
- Use ANSI escape codes to make variable names bold in interactive prompts
- Improves readability and visual hierarchy of prompts
- Update test assertions to match new bold formatting
- Update documentation to mention bold variable names
- All tests passing with new formatting
@codecov
Copy link

codecov bot commented Oct 24, 2025

Codecov Report

✅ All modified and coverable lines are covered by tests.
✅ Project coverage is 68.70%. Comparing base (0c902a6) to head (6cf3067).
⚠️ Report is 3 commits behind head on main.

Additional details and impacted files
@@            Coverage Diff             @@
##             main     #118      +/-   ##
==========================================
+ Coverage   68.06%   68.70%   +0.63%     
==========================================
  Files          20       20              
  Lines        1522     1553      +31     
  Branches      269      279      +10     
==========================================
+ Hits         1036     1067      +31     
  Misses        411      411              
  Partials       75       75              

☔ View full report in Codecov by Sentry.
📢 Have feedback on the report? Share it here.

🚀 New features to boost your workflow:
  • ❄️ Test Analytics: Detect flaky tests, report on failures, and find test suite problems.
  • 📦 JS Bundle Analysis: Save yourself from yourself by tracking and limiting bundle sizes in JS merges.

@httpdss httpdss merged commit 3a7450f into main Oct 25, 2025
5 checks passed
@httpdss httpdss deleted the feature/display-variable-descriptions-116 branch October 25, 2025 03:07
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Display variable descriptions in interactive mode prompts

2 participants