Metro is the JavaScript bundler purpose-built for React Native applications. It handles the core task of transforming and packaging React Native source code into optimized bundles that can run on mobile devices. The bundler is designed around three primary objectives: achieving sub-second reload cycles and fast startup times, scaling to handle thousands of modules within a single application, and providing seamless integration with React Native projects without requiring additional configuration.
The repository was separated from the main React Native codebase into a standalone project to enable faster iteration and more responsive issue and pull request handling. The project is written in JavaScript and distributed under the MIT license, with comprehensive documentation available on the Metro website at metrobundler.dev.
Metro's core functionality encompasses multiple interconnected systems. It performs dependency resolution to understand module relationships, applies code transformations to prepare source code for mobile execution, handles asset packaging to bundle non-JavaScript resources, generates source maps for debugging, and implements build optimization techniques to reduce bundle sizes and improve load times. The bundler also includes an integrated development server that supports the rapid reload cycles critical to React Native development workflows.
Activity tracking shows that Metro maintains active engagement with its community. The most frequently applied issue labels are Needs: Triage, Bundler-related issues, and Feature Requests, suggesting the project receives consistent contributions and enhancement proposals.
Metro's development is closely connected to the broader React Native ecosystem. The project comes pre-installed with React Native, making it the default bundler for new React Native projects, though it can also be added to existing projects through the documented Getting Started guide.
The repository includes comprehensive documentation covering configuration options and usage patterns, with documentation source code maintained alongside the bundler implementation. Metro's approach to bundling emphasizes performance and scalability as first-class concerns, recognizing that mobile development workflows demand fast feedback loops and that production applications require efficient handling of large codebases. The project maintains a Code of Conduct and established contributing guidelines, setting expectations for community participation and development practices.
