MacOS Install - Flutter Documentation

Skip to main content

docs.flutter.dev uses cookies from Google to deliver and enhance the quality of its services and to analyze traffic.

Learn more OK, got it

• Install Flutter
• Start here
• Quick start
• Custom setup
• User interface
• paletteIntroduction
• view_moduleWidget catalogexpand_more
  • Overview
  • Design systemsexpand_more
    • Cupertino
    • Material components
  • Base widgetsexpand_more
    • Accessibility
    • Animation
    • Assets
    • Async
    • Basics
    • Input
    • Interaction
    • Layout
    • Painting
    • Scrolling
    • Styling
    • Text
• view_quiltLayoutexpand_more
  • Introduction
  • Build a layout
  • Lists & gridsexpand_more
    • Create and use lists
    • Create a horizontal list
    • Create a grid view
    • Create lists with different types of items
    • Create lists with spaced items
    • Work with long lists
  • Scrollingexpand_more
    • Overview
    • Use slivers to achieve fancy scrolling
    • Place a floating app bar above a list
    • Create a scrolling parallax effect
• devicesAdaptive & responsive designexpand_more
  • Overview
  • General approach
  • SafeArea & MediaQuery
  • Large screens & foldables
  • User input & accessibility
  • Capabilities & policies
  • Automatic platform adaptations
  • Best practices
  • Additional resources
• paletteDesign & themingexpand_more
  • Share styles with themes
  • Material design
  • Migrate to Material 3
  • Textexpand_more
    • Fonts & typography
    • Use a custom font
    • Export fonts from a package
    • Google Fonts packageopen_in_new
  • Custom graphicsexpand_more
    • Use custom fragment shaders
• touch_appInteractivityexpand_more
  • Add interactivity to your app
  • Gesturesexpand_more
    • Introduction
    • Handle taps
    • Drag an object outside an app
    • Drag a UI element within an app
    • Add Material touch ripples
    • Implement swipe to dismiss
  • Input & formsexpand_more
    • Create and style a text field
    • Retrieve the value of a text field
    • Handle changes to a text field
    • Manage focus in text fields
    • Build a form with validation
  • Display a snackbar
  • Implement actions & shortcuts
  • Manage keyboard focus
• photo_libraryAssets & mediaexpand_more
  • Add assets and images
  • Display images from the internet
  • Fade in images with a placeholder
  • Play and pause a video
  • Transform assets at build time
• alt_routeNavigation & routingexpand_more
  • Overview
  • Add tabs to your app
  • Navigate to a new screen and back
  • Send data to a new screen
  • Return data from a screen
  • Add a drawer to a screen
  • Set up deep linking
  • Set up app links for Android
  • Set up universal links for iOS
  • Configure web URL strategies
• animationAnimations & transitionsexpand_more
  • Introduction
  • Tutorial
  • Implicit animations
  • Animate the properties of a container
  • Fade a widget in and out
  • Hero animations
  • Animate a page route transition
  • Animate using a physics simulation
  • Staggered animations
  • Create a staggered menu animation
  • API overview
• accessibilityAccessibilityexpand_more
  • Introduction
  • UI design & styling
  • Assistive technologies
  • Accessibility testing
  • Web accessibility
• translateInternationalization
• Beyond UI
• storageData & backendexpand_more
  • State managementexpand_more
    • Introduction
    • Think declaratively
    • Ephemeral vs app state
    • Simple app state management
    • Options
  • Networking & httpexpand_more
    • Overview
    • Fetch data from the internet
    • Make authenticated requests
    • Send data to the internet
    • Update data over the internet
    • Delete data on the internet
    • Communicate with WebSockets
  • Serializationexpand_more
    • JSON serialization
    • Parse JSON in the background
  • Persistenceexpand_more
    • Store key-value data on disk
    • Read and write files
    • Persist data with SQLite
  • Firebaseexpand_more
    • Overview
    • Add Firebase to your Flutter appopen_in_new
  • Google APIs
• account_treeApp architectureexpand_more
  • Introduction
  • Architecture concepts
  • Guide to app architecture
  • Architecture case studyexpand_more
    • Overview
    • UI layer
    • Data layer
    • Dependency injection
    • Testing each layer
  • Recommendations
  • Design patterns
• integration_instructionsPlatform integrationexpand_more
  • Supported platforms
  • Build desktop apps with Flutter
  • Write platform-specific code
  • Bind to native code
  • Androidexpand_more
    • Set up Android development
    • Add a splash screen
    • Add predictive back
    • Host a native Android view
    • Calling JetPack APIs
    • Launch a Jetpack Compose activity
    • Restore state on Android
    • Target ChromeOS with Android
    • Protect your app's sensitive content
  • iOSexpand_more
    • Set up iOS development
    • Flutter on latest iOS
    • Leverage Apple's system libraries
    • Add a launch screen
    • Add iOS App Clip support
    • Add iOS app extensions
    • Host a native iOS view
    • Enable debugging on iOS
    • Restore state on iOS
  • Linuxexpand_more
    • Set up Linux development
    • Build a Linux app
  • macOSexpand_more
    • Set up macOS development
    • Build a macOS app
    • Host a native macOS view
  • Webexpand_more
    • Web support in Flutter
    • Set up web development
    • Set up a configuration file
    • Build a web app
    • Compile to WebAssembly
    • Customize app initialization
    • Add Flutter to any web app
    • Web content in Flutter
    • Web renderers
    • Display images on the web
    • Web FAQ
  • Windowsexpand_more
    • Set up Windows development
    • Build a Windows app
• extensionPackages & pluginsexpand_more
  • Use packages & plugins
  • Develop packages & plugins
  • Swift Package Managerexpand_more
    • For app developers
    • For plugin authors
  • Flutter Favorites
  • Package repositoryopen_in_new
• bug_reportTesting & debuggingexpand_more
  • Testing
  • Overview
  • Unit testingexpand_more
    • Introduction
    • Mock dependencies
  • Widget testingexpand_more
    • Introduction
    • Find widgets
    • Simulate scrolling
    • Simulate user interaction
  • Integration testingexpand_more
    • Introduction
    • Write and run an integration test
    • Profile an integration test
  • Test a plugin
  • Handle plugin code in tests
  • Debugging
  • Debugging tools
  • Debug your app programmatically
  • Use a native language debugger
  • Common Flutter errors
  • Handle errors
  • Report errors to a service
• speedPerformance & optimizationexpand_more
  • Overview
  • Impeller
  • Performance best practices
  • App size
  • Deferred components
  • Rendering performance
  • Performance profiling
  • Performance profiling for web
  • Performance metrics
  • Concurrency and isolates
  • Performance FAQ
  • Appendix
• rocket_launchDeploymentexpand_more
  • Obfuscate Dart code
  • Create app flavors for Android
  • Create app flavors for iOS and macOS
  • Build and release an Android app
  • Build and release an iOS app
  • Build and release a macOS app
  • Build and release a Linux app
  • Build and release a Windows app
  • Build and release a web app
  • Set up continuous deployment
• add_circleAdd to an existing appexpand_more
  • Introduction
  • Add to an Android appexpand_more
    • Set up Android project
    • Add a single Flutter screen
    • Add a Flutter Fragment
    • Add a Flutter View
    • Use a Flutter plugin
  • Add to an iOS appexpand_more
    • Set up iOS project
    • Add a single Flutter screen
  • Add to a web app
  • Debug embedded Flutter module
  • Add multiple Flutter instances
  • Loading sequence and performance
• Resources
• constructionTools & editorsexpand_more
  • Android Studio & IntelliJ
  • Visual Studio Code
  • DevToolsexpand_more
    • Overview
    • Run from Android Studio & IntelliJ
    • Run from VS Code
    • Run from command line
    • Flutter inspector
    • Legacy Flutter inspector
    • Performance view
    • CPU Profiler view
    • Memory view
    • Debug console view
    • Network view
    • Debugger
    • Logging view
    • App size tool
    • DevTools extensions
    • Validate deep links
    • Release notes
  • Flutter Widget Previewer
  • Flutter Property Editor
  • SDK overview
  • Flutter's pubspec options
  • Automated fixes
  • Code formatting
• lightbulbFlutter conceptsexpand_more
  • Architectural overview
  • Inside Flutter
  • Understanding constraints
  • Flutter's build modes
  • Hot reload
• appsApp solutionsexpand_more
  • Develop with Firebaseexpand_more
    • Overview
    • Discover Firebase for Flutteropen_in_new
    • Get to know Firebase for Flutteropen_in_new
    • Add a user authentication flow to a Flutter app using FirebaseUIopen_in_new
    • Get to know Firebase for webopen_in_new
  • Build multi-platform gamesexpand_more
    • Overview
    • Add achievements and leaderboards
    • Build leaderboards with Firestoreopen_in_new
    • Add advertising
    • Add multiplayer support
    • Add in-app purchasesopen_in_new
    • Add user authenticationopen_in_new
    • Debug using Crashlyticsopen_in_new
    • Intro to Flame with Flutteropen_in_new
  • Monetize your appexpand_more
    • Integrate adsexpand_more
      • Ads overview
      • Add advertising
      • Add AdMob ads to your Flutter appopen_in_new
      • Add an AdMob banner and native inline adsopen_in_new
      • Integrate multimedia ads (video)open_in_new
      • Google AdMob mediationopen_in_new
      • Interactive Media Ads SDKopen_in_new
    • Support paymentsexpand_more
      • Payments overview
      • Google pay packageopen_in_new
    • Add in-app purchasesopen_in_new
  • Integrate mapsexpand_more
    • Add Google maps to a Flutter appopen_in_new
    • Google Maps packageopen_in_new
  • AI solutionsexpand_more
    • Create with AI
    • Rules for AI
    • AI best practicesexpand_more
      • Overview
      • Prompting
      • Structure & output
      • Tool calls (aka function calls)
      • Mode of interaction
      • Developer experience
    • AI Toolkitexpand_more
      • Overview
      • User experience
      • Feature integration
      • Custom LLM providers
      • Chat client sample
    • GenUI SDK for Flutterexpand_more
      • Overview
      • Main components & concepts
      • Get started
      • Input and events
    • Dart & Flutter MCP server
    • Flutter extension for Gemini CLI
    • Firebase AI Logicopen_in_new
• devicesFrom another platform?expand_more
  • Flutter for Android devs
  • Flutter for Jetpack Compose devs
  • Flutter for SwiftUI devs
  • Flutter for UIKit devs
  • Flutter for React Native devs
  • Flutter for web devs
  • Flutter for Xamarin.Forms devs
  • Introduction to declarative UI
  • Flutter versus Swift concurrency
• updateStay up to dateexpand_more
  • Release notes
  • Breaking changes
  • Compatibility policy
  • Flutter blogopen_in_new
  • What's new in the docs
• computerManage installexpand_more
  • SDK archive
  • Upgrade SDK
  • Add to path
  • Troubleshoot
  • Uninstall SDK
• library_booksResourcesexpand_more
  • FAQ
  • Videos
  • Courses
  • Glossary
  • Get support
  • Contributeexpand_more
    • Contribute to Flutter
    • Create useful bug reports
    • Discover proposed features
  • Referenceexpand_more
    • Who is Dash?
    • Widget index
    • Create a new app
    • flutter CLI
    • API docsopen_in_new

But Dash is here to help - maybe one of these will point you in the right direction?

• Homepage
• Package site
• API reference
• Documentation
• Community
• Blog
• X (Twitter)
• FAQ

Was this page's content helpful? thumb_up thumb_down

Unless stated otherwise, the documentation on this site reflects Flutter 3.38.6. Page last updated on 2025-10-30. View source or report an issue.