Skip to content

Correct and expand feature list in project documentation - #257

Closed
richardthe3rd with Copilot wants to merge 1 commit into
mainfrom
copilot/update-readme
Closed

Correct and expand feature list in project documentation#257
richardthe3rd with Copilot wants to merge 1 commit into
mainfrom
copilot/update-readme

Conversation

Copilot AI commented May 11, 2026

Copy link
Copy Markdown
Contributor

The documented feature list was stale: it omitted several shipped capabilities and used beer-specific wording in places where the app now supports multiple drink types and festival-level navigation. This update brings the feature summary back in line with the current product surface area.

  • Scope

    • Refreshes the feature list to reflect current app behavior rather than an older beer-centric subset.
    • Rewords ambiguous items so the list matches the app’s broader drinks/festival model.
  • Feature coverage updates

    • Adds missing capabilities:
      • multi-festival browsing and switching
      • support for all drink categories currently exposed by the app
      • allergen-based filtering
      • style detail pages
      • festival info pages
      • drink sharing
      • theme selection
    • Keeps existing core capabilities called out:
      • search
      • category/style filtering
      • sort options
      • favorites
      • ratings
      • drink detail views
  • Terminology cleanup

    • Replaces beer-only phrasing with terms that match the data model and UI:
      • brewerybrewery/producer where appropriate
      • beer/beersdrink/drinks where the feature applies across categories
    • Clarifies that platform support remains Android, iOS, and Web.
  • Example

    - Browse drinks by festival
    - Browse multiple drink categories (beer, cider, perry, mead, wine, international beer, low/no)
    - Filter by category and style
    - Filter out selected allergens
    - Switch between festivals
    - View festival info
    - Share drink links/details
    - Choose light, dark, or system theme

Agent-Logs-Url: https://github.com/richardthe3rd/cambridge-beer-festival-app/sessions/58d41a14-d3ff-4dc6-be8a-8e292ad4aa2d

Co-authored-by: richardthe3rd <573334+richardthe3rd@users.noreply.github.com>
@richardthe3rd
richardthe3rd marked this pull request as ready for review May 11, 2026 19:03
Copilot AI review requested due to automatic review settings May 11, 2026 19:03

Copilot AI left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

Updates the README’s setup/workflow documentation to align with the repo’s current mise-based task approach, adds more explicit task commands, and refreshes the documented project structure/testing sections.

Changes:

  • Reworks “Getting Started” to prefer ./bin/mise tasks (including dev env via MISE_ENV=dev).
  • Expands documented task list (generate/analyze/test/coverage, web build, e2e).
  • Updates the documented directory structure and testing/coverage notes (including E2E commands).

Comment thread README.md
Comment on lines 62 to 66
### Development Tasks

If using mise, you can run these convenient tasks:
The repository standard is to use `./bin/mise`:

```bash
Comment thread README.md
Comment on lines +43 to +55
# Discover available tasks
./bin/mise tasks ls
MISE_ENV=dev ./bin/mise tasks ls

# Option 2: Manual setup
flutter pub get
# Install managed tools
./bin/mise install

# Run core checks
./bin/mise run test
./bin/mise run analyze

# Run the app
flutter run
# Start the web dev server
MISE_ENV=dev ./bin/mise run dev
Comment thread README.md
Comment on lines +144 to +149
```bash
MISE_ENV=dev ./bin/mise run setup:playwright
MISE_ENV=dev ./bin/mise run build:web
MISE_ENV=dev ./bin/mise run serve:release
MISE_ENV=dev ./bin/mise run test:e2e
```
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants