How facebook/create-react-app works
Project type and purpose
• This is an open-source monorepo tool (Create React App) for bootstrapping React single-page applications with zero build configuration.
• It provides a CLI (create-react-app), a core runtime (react-scripts), templates (cra-template, cra-template-typescript), presets/plugins (Babel, ESLint), supporting libraries (dev-utils, error-overlay), documentation (Docusaurus), tests, and CI/CD workflows.
File structure
• Top level: Lerna config (lerna.json), monorepo governance, CI/CD configs (.github/workflows, netlify.toml), task scripts.
• /packages: dozens of self-contained packages:
• CLI (create-react-app)
• Templates (cra-template*)
• Core runtime (react-scripts) with subfolders for webpack/Babel/Jest configs and scripts (start, build, test, eject)
• Supporting libs (react-dev-utils, react-error-overlay, presets, polyfills, plugins, ESLint config)
• /docusaurus: docs site source & config.
• /tasks: shell/js scripts for publishing, e2e tests, local registry.
• /test: test fixtures and integration tests.
README
• Explains purpose: hide build tools behind a single dependency (react-scripts), provide one-line project creation, support dev server, tests, build.
• Highlights “eject” feature to extract hidden configs.
• Outlines philosophies: one dependency, no config, no lock-in.