project-structure.md

Project Structure

Related topics:

• Boilerplates and Starter Kits
• React Component Patterns
• React State Management
• React and Forms
• React and AJAX
• React Architecture and Best Practices
• Redux Architecture and Best Practices

Project File Structure

• Scaling React.js Applications
  https://vimeo.com/168648012
  Max Stoiber's talk about managing large react.js applications. Covers "Feature" structure, redux-saga and CSS modules.

• How to Scale React Applications
  https://www.smashingmagazine.com/2016/09/how-to-scale-react-applications/
  https://twitter.com/dan_abramov/status/773912160896421889
  Max Stoiber, creator of the popular "React-Boilerplate" starter kit, describes the approaches they use to lay out projects based on features. The Twitter thread has discussion on some tradeoffs, including understand that Redux actions are "global", not scoped.

• Organizing Large React Applications
  http://engineering.kapost.com/2016/01/organizing-large-react-applications/
  Describes "File-Type First", "Feature First / Pods" approaches, as well as other related structure issues.

• Four Strategies for Organizing Code
  https://medium.com/@msandin/strategies-for-organizing-code-2c9d690b6f33
  Describes "by component", "by toolbox", "by layer", and "by kind" approaches.

• Rules for Structuring (Redux) Applications
  http://jaysoo.ca/2016/02/28/organizing-redux-application/
  http://jaysoo.ca/2016/02/28/applying-code-organization-rules-to-concrete-redux-code/
  http://jaysoo.ca/2016/12/12/additional-guidelines-for-project-structure/
  Gives several useful rules for structuring code, with examples.

• A Better File Structure for React/Redux Applications
  http://marmelab.com/blog/2015/12/17/react-directory-structure.html
  Suggests a domain-based structure, with tests kept alongside the code they relate to.

• Route-Based Folder Structure
  https://gist.github.com/ryanflorence/daafb1e3cb8ad740b346
  Ryan Florence, an author of React Router, gives his suggested file structure.

• How to Better Organize Your React Applications?
  https://medium.com/@alexmngn/how-to-better-organize-your-react-applications-2fd3ea1920f1
  Another feature-style approach, describing things in terms of "components", "scenes", and "services".

• Fractal Project Structure
  https://github.com/davezuko/react-redux-starter-kit/wiki/Fractal-Project-Structure
  Docs from the React Redux Starter Kit project describing their "Fractal Project Structure" concept, and advice for file and app organization.

• Redux Structure: a Way to Success
  https://datarockets.com/blog/redux-structure
  Thoughts on a "modules and components"-based approach to file structure,

• My journey toward a maintainable project structure for React/Redux
  https://hackernoon.com/my-journey-toward-a-maintainable-project-structure-for-react-redux-b05dfd999b5
  Describes an evolution of approaches for project structure

• Building Modular Redux Applications
  https://vimeo.com/album/4199344/video/187454108
  A talk discussing an approach to Redux structure by splitting logic into "data providers/sources" and presentation.

• How to Structure real world Redux/React Applications
  https://medium.com/@yiquanzhou/how-to-structure-real-world-redux-react-application-d61e66a7dd36
  Another look at structuring code, based on business logic, data domains, and reusability.

• When a good plan comes together: React project structure for scaling
  http://web.archive.org/web/20170706123441/http://thereactionary.net/when-a-good-plan-comes-together-react-project-structure-for-scaling/
  More discussion of tradeoffs in various structure approaches.

• Structuring and Organizing the React Components Directory
  http://noah-prince-tech-blog.ghost.io/structuring-and-organizing-the-react-components-directory/
  Some useful suggestions for folder layout, folder naming, and import handling.

• How OkCupid organizes its multi-page React App
  https://tech.okcupid.com/how-okcupid-organizes-its-multi-page-react-app/
  https://www.reddit.com/r/reactjs/comments/5widfg/how_okcupid_organizes_its_multipage_react_app/
  The OkCupid team discusses their approach for a multi-page app, including bundles, use of the Ducks pattern, and folder structures. Some good follow-up discussion in the Reddit comments.

• React Project Structure
  https://daveceddia.com/react-project-structure/
  An excellent article that gives practical advice for structuring the source of a React app, especially if you're a beginner or using create-react-app.

• Decoupling Hierarchies for Maintainable Code
  https://medium.com/altschool-engineering/decoupling-hierarchies-for-maintainable-code-b13c24b2f047
  Some very interesting thoughts on how component structure, data flow, and folder structure can interact with each other.

• Writing Scalable React Apps with the Component Folder Pattern
  https://medium.com/styled-components/component-folder-pattern-ee42df37ec68
  Describes a specific variation on "feature folders" that puts all files for a given component in a separate folder, as well as an approach for providing configurable component rendering with default behavior as a fallback.

• Fractal: A React app structure for infinite scale
  https://hackernoon.com/fractal-a-react-app-structure-for-infinite-scale-4dab943092af

• Domain directory structure for React apps - why it's worth trying
  https://tech.offgrid-electric.com/domain-directory-structure-for-react-apps-why-its-worth-trying-b3855ee77a1e
  Discusses experience with the "A Better File Structure" approach, and gives advice on best practices for import paths, creating sub-domains, and more.

• The 100% correct way to structure a React app (or why there's no such thing
  https://hackernoon.com/the-100-correct-way-to-structure-a-react-app-or-why-theres-no-such-thing-3ede534ef1ed
  An extensive set of pragmatic thoughts on good practices for React project structure. Tries to quantify time spent on activities like creating new files and switching editor tabs, and gives some opinions on which patterns are more useful.