Update .gitignore

Author: stepanic

.gitignore

@@ -1,85 +1,67 @@
-# Do not remove or rename entries in this file, only add new ones
-# See https://github.com/flutter/flutter/issues/128635 for more context.
-
-# This is dynamic in a monorepo
-bin/internal/engine.version
-
-# Miscellaneous
-*.class
-*.lock
-*.log
-*.pyc
-*.swp
-.DS_Store
-.atom/
-.buildlog/
-.history
-.svn/
-
-# IntelliJ related
-*.iml
-*.ipr
-*.iws
-.idea/
+# ==============================================================================
+# Flutter & Dart Common .gitignore
+# ==============================================================================
+#
+# This file is organized in two sections:
+#   1. Common Rules: Always applied for both Flutter apps and libraries.
+#   2. Specific Rules: Sensitive or optional rules that are active by default.
+#
+# By default, this configuration is conservative:
+# Sensitive/generated files are ignored unless you deliberately modify the file.
+# ==============================================================================
+
+###############################################################################
+# 1. Common Rules for Flutter Applications and Libraries
+###############################################################################
+
+## Flutter & Dart Generated Files & Caches
+# Build artifacts and generated files (do not commit these)
+build/
+coverage/
+.dart_tool/
+.fvm/
 
-# Visual Studio Code related
-.classpath
-.project
-.settings/
-.vscode/*
-.ccls-cache
+# Plugin-related generated files
+.flutter-plugins
+.flutter-plugins-dependencies
 
-# Flutter repo-specific
-/bin/cache/
-/bin/internal/bootstrap.bat
-/bin/internal/bootstrap.sh
-/bin/mingit/
-/dev/benchmarks/mega_gallery/
-/dev/bots/.recipe_deps
-/dev/bots/android_tools/
-/dev/devicelab/ABresults*.json
-/dev/docs/doc/
-/dev/docs/api_docs.zip
-/dev/docs/flutter.docs.zip
-/dev/docs/lib/
-/dev/docs/pubspec.yaml
-/dev/integration_tests/**/xcuserdata
-/dev/integration_tests/**/Pods
-/packages/flutter/coverage/
-version
-analysis_benchmark.json
+# Generated plugin registrant for Flutter web and other platforms
+lib/generated_plugin_registrant.dart
 
-# packages file containing multi-root paths
-.packages.generated
+# Documentation generated by dartdoc
+doc/api/
 
-# Flutter/Dart/Pub related
-**/doc/api/
-.dart_tool/
-.flutter-plugins
-.flutter-plugins-dependencies
-**/generated_plugin_registrant.dart
-.packages
-.pub-preload-cache/
+# Dependency cache directories
 .pub-cache/
 .pub/
-build/
-flutter_*.png
-linked_*.ds
-unlinked.ds
-unlinked_spec.ds
 
-# Android related
+## Platform-Specific Build Artifacts
+
+### Android
+# Gradle wrapper and build system files
 **/android/**/gradle-wrapper.jar
-.gradle/
+**/android/.gradle/
 **/android/captures/
 **/android/gradlew
 **/android/gradlew.bat
+
+# Local configuration files (do not commit these)
 **/android/local.properties
-**/android/**/GeneratedPluginRegistrant.java
 **/android/key.properties
+
+# Auto-generated plugin registrant
+**/android/**/GeneratedPluginRegistrant.java
+
+# Keystore files (if present)
 *.jks
 
-# iOS/XCode related
+# Android Studio build outputs
+/android/app/debug
+/android/app/profile
+/android/app/release
+
+### iOS & Xcode
+# Xcode and iOS build artifacts
 **/ios/**/*.mode1v3
 **/ios/**/*.mode2v3
 **/ios/**/*.moved-aside
@@ -94,8 +76,10 @@ unlinked_spec.ds
 **/ios/**/Pods/
 **/ios/**/.symlinks/
 **/ios/**/profile
-**/ios/**/xcuserdata
+**/ios/**/xcuserdata/
 **/ios/.generated/
+
+# Flutter iOS-specific build files
 **/ios/Flutter/.last_build_id
 **/ios/Flutter/App.framework
 **/ios/Flutter/Flutter.framework
@@ -109,44 +93,120 @@ unlinked_spec.ds
 **/ios/ServiceDefinitions.json
 **/ios/Runner/GeneratedPluginRegistrant.*
 
-# macOS
-**/Flutter/ephemeral/
-**/Pods/
+# Exceptions: Retain default Xcode configuration files
+!**/ios/**/default.mode1v3
+!**/ios/**/default.mode2v3
+!**/ios/**/default.pbxuser
+!**/ios/**/default.perspectivev3
+
+### macOS
+# macOS build and generated files
 **/macos/Flutter/GeneratedPluginRegistrant.swift
 **/macos/Flutter/ephemeral
 **/xcuserdata/
 
-# Windows
+### Windows
+# Windows build and generated files
 **/windows/flutter/ephemeral/
 **/windows/flutter/generated_plugin_registrant.cc
 **/windows/flutter/generated_plugin_registrant.h
 **/windows/flutter/generated_plugins.cmake
 
-# Linux
+### Linux
+# Linux build and generated files
 **/linux/flutter/ephemeral/
 **/linux/flutter/generated_plugin_registrant.cc
 **/linux/flutter/generated_plugin_registrant.h
 **/linux/flutter/generated_plugins.cmake
 
-# Coverage
-coverage/
-
-# Symbols
-app.*.symbols
+## IDEs and Editor Settings
+# IntelliJ IDEA and Android Studio project files
+*.iml
+*.ipr
+*.iws
+.idea/
 
-# Exceptions to above rules.
-!**/ios/**/default.mode1v3
-!**/ios/**/default.mode2v3
-!**/ios/**/default.pbxuser
-!**/ios/**/default.perspectivev3
-!/packages/flutter_tools/test/data/dart_dependencies_test/**/.packages
-!/dev/ci/**/Gemfile.lock
+# Eclipse, VS Code, and related settings
+.classpath
+.project
+.settings/
+.vscode/*
 !.vscode/settings.json
+.ccls-cache
+
+# Other editors
+.atom/
+
+## Miscellaneous System Files & Temporary Files
+.DS_Store
+.buildlog/
+.history
+.svn/
+*.pyc
+*.swp
+
+## Web & JavaScript Generated Files
+*.dart.js
+*.info.json
+*.js
+*.js_
+*.js.deps
+*.js.map
+
+## Environment Variable Files
+.env*
+
+## Symbolication and Obfuscation Files
+app.*.symbols
+app.*.map.json
+
+###############################################################################
+# 2. Specific Rules (Active by Default)
+###############################################################################
+#
+# These rules target files and directories that might contain sensitive data
+# or are used in specific contexts (e.g. Flutter framework repos, libraries).
+# If you need to commit any of these files (for example, in a Flutter app),
+# manually comment out the corresponding rule.
+#
+
+# ------------------------------------------------------------------------------
+# Dependency Management: Pubspec Lock File
+# ------------------------------------------------------------------------------
+# For Flutter applications it is recommended to commit pubspec.lock.
+# For libraries, ignoring pubspec.lock avoids unintentional publishing.
+# By default, this rule is active (conservative). Comment it out if you want to commit pubspec.lock.
+pubspec.lock
+
+# ------------------------------------------------------------------------------
+# Firebase Configuration Files
+# ------------------------------------------------------------------------------
+# The .firebase folder may contain sensitive Firebase credentials.
+# Ignoring it by default prevents accidental commits. Comment out if you need to include it.
+.firebase/
+
+# ------------------------------------------------------------------------------
+# Flutter Repository–Specific Files (Monorepos/Framework Repos)
+# ------------------------------------------------------------------------------
+# These files are part of the Flutter framework repository.
+# If you are not working on the Flutter framework itself, these should remain ignored.
+bin/internal/engine.version
+/bin/cache/
+/bin/internal/bootstrap.*
+/bin/mingit/
+dev/benchmarks/mega_gallery/
+dev/bots/
+dev/devicelab/
+dev/docs/
+dev/integration_tests/
+packages/flutter/coverage/
+version
+analysis_benchmark.json
+.packages.generated
 
-# Monorepo
-.cipd
-.gclient
-.gclient_entries
-.python-version
-.gclient_previous_custom_vars
-.gclient_previous_sync_commits
+# ------------------------------------------------------------------------------
+# Additional Local Environment or Custom Use Cases
+# ------------------------------------------------------------------------------
+# If you have local editor configuration files or other custom setups that
+# you prefer not to share, they are ignored by default.
+.vscode/