How r-park/todo-react-redux works
Project type and purpose
• This is a single-page, full-stack style web application (a Todo app) built with Create React App, React Redux, React Router, and Firebase as a backend-as-a-service.
• Its main purpose is to demonstrate a fully reactive Todo list with undo/undelete, authentication via Firebase OAuth, and real-time data persistence in Firebase Realtime Database, all wrapped up as a PWA.
File structure
• Top-level artifacts:
• public/ — static assets & PWA manifest
• src/ — React source code
• .firebaserc, firebase.json — Firebase project & hosting config
• circle.yml — CI configuration
• src/ is subdivided into:
• auth, tasks, notification modules (actions, reducers, selectors, tests)
• firebase/ — wrappers around Firebase SDK (config, initialization, lists)
• views/ — React components (atomic button, header, task-list, pages)
• store.js, reducers.js, history.js — Redux store setup and routing integration
• Build & deployment scripts are defined in package.json; tests co-located next to modules.
README for additional insights
• Confirms tech stack: CRA, React Redux, React Router, Redux Thunk, Firebase SDK, Immutable, Reselect, SASS.
• Outlines CI via CircleCI badge and deployment via Firebase CLI.
• Mentions service worker registration for PWA capabilities.
Elements
– UI → Dispatcher → Thunk → Firebase SDK → Database / Auth
– Database events → SDK callbacks → Reducers → UI
– Git push → CircleCI → build → Firebase deploy
– Blue for client-side (UI, store, service worker)
– Green for Firebase services
– Orange for CI/CD pipeline
– Clouds for external services
Detailed breakdown
• Frontend Layer:
– index.html → index.js → App component → Route components (SignInPage, TasksPage)
– Atomic UI components (button, header, task-item, etc.)
– Redux modules (auth, tasks, notification) wired into store.js
– Middleware: Redux Thunk
– Reselect selectors feeding props to components
• Backend Layer (Firebase):
– config.js loads project credentials
– firebase-list.js wraps Realtime Database CRUD
– auth.js handles user session and guards routes
• PWA Layer:
– register-service-worker.js registers the service worker generated by CRA
• CI/CD Layer:
– circle.yml defines test and build jobs
– firebase.json & .firebaserc define hosting target
• Testing:
– Spec files alongside reducers, actions, components (Jest tests)