Skip to content

Flutter version mismatch in documentation (3.35 vs 3.38.5)Β #7320

@DivvSaxena

Description

@DivvSaxena

###What

Documentation references outdated Flutter version (3.35/3.35.1) instead of the actual required version (3.38.5), causing setup failures for new contributors.

Steps to reproduce the behavior

  1. Follow the setup instructions in README.md (lines 80-88)
  2. Install Flutter 3.35.1 using fvm install 3.35.1 and fvm use 3.35.1
  3. Navigate to packages/smooth_app directory
  4. Run fvm flutter pub get
  5. See error: The current Dart SDK version is 3.9.0. Because smooth_app requires SDK version ^3.10.4, version solving failed.

Expected behavior

The documentation should reference Flutter 3.38.5 (as specified in flutter-version.txt), which includes Dart 3.10.4, allowing pub get to succeed.

Why

  • This blocks new contributors from successfully setting up the development environment
  • Wastes time troubleshooting a version mismatch that shouldn't exist
  • The documentation is inconsistent across multiple files

Files affected:

  • README.md (line 80): mentions 3.35
  • .github/copilot-instructions.md (line 10, 16-18): mentions 3.35.1
  • flutter-version.txt (source of truth): correctly shows 3.38.5

Part of

N/A

Screenshot/Mockup/Before-After

Error when using Flutter 3.35.1:
The current Dart SDK version is 3.9.0.
Because smooth_app requires SDK version ^3.10.4, version solving failed.

Success after using Flutter 3.38.5:
Got dependencies!

Smartphone model

Environment where issue was discovered:

  • Device: iPhone (iOS 18.5)
  • Development OS: macOS 15.5
  • Encountered during: First-time local setup on 2024-12-30

Additional context

I encountered this issue while setting up the project locally for the first time on my iOS development environment. After following the README instructions with Flutter 3.35.1, the build failed. Only after checking flutter-version.txt and switching to Flutter 3.38.5 did the setup succeed.

Fix: Update all documentation to reference Flutter 3.38.5 to match flutter-version.txt.

I'm happy to submit a PR to fix these documentation inconsistencies.

Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels

    Projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions