.gitignore

# ==============================================================================
# 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/

# Plugin-related generated files
.flutter-plugins
.flutter-plugins-dependencies

# Generated plugin registrant for Flutter web and other platforms
lib/generated_plugin_registrant.dart

# Documentation generated by dartdoc
doc/api/

# Dependency cache directories
.pub-cache/
.pub/

## Platform-Specific Build Artifacts

### Android
# Gradle wrapper and build system files
**/android/**/gradle-wrapper.jar
**/android/.gradle/
**/android/captures/
**/android/gradlew
**/android/gradlew.bat

# Local configuration files (do not commit these)
**/android/local.properties
**/android/key.properties

# Auto-generated plugin registrant
**/android/**/GeneratedPluginRegistrant.java

# Keystore files (if present)
*.jks

# 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
**/ios/**/*.pbxuser
**/ios/**/*.perspectivev3
**/ios/**/*sync/
**/ios/**/.sconsign.dblite
**/ios/**/.tags*
**/ios/**/.vagrant/
**/ios/**/DerivedData/
**/ios/**/Icon?
**/ios/**/Pods/
**/ios/**/.symlinks/
**/ios/**/profile
**/ios/**/xcuserdata/
**/ios/.generated/

# Flutter iOS-specific build files
**/ios/Flutter/.last_build_id
**/ios/Flutter/App.framework
**/ios/Flutter/Flutter.framework
**/ios/Flutter/Flutter.podspec
**/ios/Flutter/Generated.xcconfig
**/ios/Flutter/ephemeral
**/ios/Flutter/app.flx
**/ios/Flutter/app.zip
**/ios/Flutter/flutter_assets/
**/ios/Flutter/flutter_export_environment.sh
**/ios/ServiceDefinitions.json
**/ios/Runner/GeneratedPluginRegistrant.*

# 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 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 build and generated files
**/linux/flutter/ephemeral/
**/linux/flutter/generated_plugin_registrant.cc
**/linux/flutter/generated_plugin_registrant.h
**/linux/flutter/generated_plugins.cmake

## IDEs and Editor Settings
# IntelliJ IDEA and Android Studio project files
*.iml
*.ipr
*.iws
.idea/

# 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

# ------------------------------------------------------------------------------
# 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/