How shoutem/school works
This repository is a portfolio of independent React Native tutorial apps, not one single product. Each top-level app folder is a self-contained mobile application with its own JS entrypoints, native Android/iOS shells, and app-specific state/data layer.
The common mobile-app shape is consistent across most folders: index.android.js and index.ios.js boot the React Native app, src/ holds the UI/state logic, and android/ + ios/ contain the native wrappers, assets, and platform build files. Tests live in __tests__/, and most apps use Redux-style state management or similar unidirectional flows.
ChatApp is the clearest full-stack example. Its front end is split into UI components, containers, actions, reducers, and a firebase.js integration layer. The app reads/writes chat data through Firebase, and its iOS folder includes vendored Firebase frameworks plus GoogleService-Info.plist, showing that Firebase is a first-class external dependency.
ChatAppFirebaseFunctions is the backend companion for ChatApp. It contains Firebase Realtime Database rules and Cloud Functions, so the system boundary is client app ↔ Firebase backend ↔ serverless functions. That backend layer handles push/notification or database-side logic rather than running as a standalone server.
Recipes_app is the most architecturally complex subtree. It is a Shoutem-based app platform with a root app plus a large extensions/ directory. The platform is extension-driven: each extension declares metadata in extension.json and typically has an app/ part for the mobile runtime and a server/ part for builder/admin UI and content configuration.
Inside Recipes_app/extensions, the mobile-side extensions provide feature screens and components such as navigation, auth, page rendering, photos, events, news, RSS, video, YouTube, Shopify, web view, loyalty, push notifications, and analytics. The server-side counterparts define configuration pages, reducers, CMS-style forms, and data schemas, so the architecture is split between runtime content consumption and authoring/configuration.
The Recipes_app/server folders are not generic backend APIs; they are extension-specific admin/build surfaces. Many contain data-schemas/, page components, reducers, and builder SDK helpers, which indicates a content-management and app-builder model rather than a traditional client-server CRUD backend.
Recipes_app/scripts provides the platform tooling that glues the system together. The scripts handle build, bundle, configuration, extension installation, platform updates, and environment-specific app assembly. This means the root app is dynamically composed from a selected set of extensions and platform settings.
A key architectural boundary in Recipes_app is content schema vs. presentation. Extensions such as shoutem.cms, shoutem.events, shoutem.news, shoutem.menu, shoutem.products, and shoutem.places define schemas and server-side configuration, while their app/ folders render lists, details, maps, and media views from those content models.
Several extensions provide cross-cutting infrastructure rather than end-user features. Examples include navigation, theme, persistence, analytics, code push, push notifications, and auth. These modules wrap the app shell, inject reducers/middleware, and alter routing, theming, or device capabilities across many feature extensions.
The other standalone sample apps are each narrow vertical demos with their own local data flow. For example, HackerNewsApp centers on HNApi, store/state management, story/detail/comment actions, and voting; MusicApp ties player UI to SoundCloud/Flickr helpers; TravelApp uses a packing list and Flickr-backed images; CryptoDataVizApp is a data-visualization app with graph components and helper logic; LiveInstagram focuses on camera/filter rendering; and LunchSpotApp centers on recommendations and map/topic views.
_ChatApp is a near-duplicate/built variant of the chat sample, including vendored CocoaPods and Firebase artifacts. It shows the same architecture as ChatApp, but with checked-in native dependencies and generated iOS support files.
Overall, the repo’s diagram should show a monorepo of isolated tutorial apps, with Recipes_app as an extension-based platform and ChatApp + ChatAppFirebaseFunctions as the only obvious full-stack client/server pair. The dominant patterns are React Native UI, Redux-style state flow, native platform shells, and external integrations such as Firebase, SoundCloud, Flickr, Shopify, analytics SDKs, and push-notification services.
Main entry points: extensions Extensions · ChatApp ChatApp · Recipes_app Recipes app · HackerNewsApp HackerNewsApp
Components 34
Chat stack
React Native chat client and its Firebase functions backend.
- ChatApp · Firebase-backed chat client with Redux-style UI/state flow.
ChatApp - Chat UI · Main chat and login presentation components.
ChatApp/src/components - Containers · Input and message containers connecting UI to actions/state.
ChatApp/src/containers - State flow · Actions and reducers for chatroom, messages, and user state.
ChatApp/src/reducers - Firebase · Client-side Firebase access layer used by the chat app.
ChatApp/src/firebase.js - Functions · Realtime Database rules and Cloud Functions companion for ChatApp.
ChatAppFirebaseFunctions
Recipes platform
Extension-driven Shoutem app platform with mobile runtime, server-side authoring surfaces, and build tooling.
- Recipes app · Extension-composed mobile app platform with native shells, scripts, and many feature modules.
Recipes_app - App shell · Root entrypoints that assemble the Shoutem mobile app.
Recipes_app/index.js - Build scripts · Build, bundle, configure, and update platform assembly tooling.
Recipes_app/scripts - Extensions · Feature and infrastructure extensions composing the app.
Recipes_app/extensions - Navigation · Cross-cutting routing and shell layout extension.
Recipes_app/extensions/shoutem.navigation - CMS · Content-schema and builder-side authoring extension.
Recipes_app/extensions/shoutem.cms - Loyalty · Reward, points, and merchant workflow extension.
Recipes_app/extensions/shoutem.loyalty - Shopify · Commerce extension with cart and checkout flows.
Recipes_app/extensions/shoutem.shopify - News · Article-driven content extension with list and detail screens.
Recipes_app/extensions/shoutem.news - Media feeds · RSS, YouTube, Vimeo, video, photo, and web-view extensions.
Recipes_app/extensions/shoutem.rss - Favorites · Shared favorites state and presentation support.
Recipes_app/extensions/shoutem.favorites - Push · Push-notification permissions and notification-center plumbing.
Recipes_app/extensions/shoutem.push-notifications - Theme · App-wide theme and asset resolution support.
Recipes_app/extensions/shoutem.theme
Sample apps
Independent tutorial apps and demos with their own local state and integrations.
- HackerNewsApp · Hacker News reader with API/store/story flows.
HackerNewsApp - HN API · Hacker News API helper and item/story retrieval.
HackerNewsApp/src/HNApi.js - Store · App store and story/comment/vote state handling.
HackerNewsApp/src/Store.js - MusicApp · Music player demo tied to SoundCloud and Flickr helpers.
MusicApp - Player · Playback controls and audio UX.
MusicApp/src/Player.js - Helpers · SoundCloud and Flickr helper modules for media and artwork.
MusicApp/src/soundcloudHelper.js - TravelApp · Packing-list travel demo with Flickr-backed images.
TravelApp - Packing flow · Packing list, item entry, and app store logic.
TravelApp/src/store.js - CryptoDataVizApp · Crypto visualization demo centered on graphs and transaction data.
CryptoDataVizApp - Graphs · Stream and volume chart components plus current value display.
CryptoDataVizApp/src/StreamGraph.js - LiveInstagram · Camera and rendering demo focused on live image processing.
LiveInstagram - LunchSpotApp · Recommendation and map/topic demo for lunch spot discovery.
LunchSpotApp - CommitApp · Commitment-tracking demo with editing and display flows.
CommitApp - ColorPicker · Small color selection demo.
ColorPicker/src/App.js
Other components
- school · Portfolio of isolated React Native tutorial apps plus one extension-based platform.
Connections 34
- school → ChatApp: hosts · Repository contains the ChatApp tutorial client.
- school → Functions: hosts · Repository contains the Firebase companion backend.
- school → Recipes app: hosts · Repository contains the Shoutem platform app.
- school → HackerNewsApp: hosts · Repository contains the HackerNews tutorial app.
- school → MusicApp: hosts · Repository contains the music tutorial app.
- school → TravelApp: hosts · Repository contains the travel tutorial app.
- school → CryptoDataVizApp: hosts · Repository contains the crypto visualization app.
- school → LiveInstagram: hosts · Repository contains the LiveInstagram demo.
- school → LunchSpotApp: hosts · Repository contains the lunch spot demo.
- school → CommitApp: hosts · Repository contains the commitment demo.
- school → ColorPicker: hosts · Repository contains the ColorPicker sample.
- ChatApp → Chat UI: renders · App UI is split into chat and login components.
- ChatApp → Containers: connects · Containers bridge UI events to app state.
- ChatApp → State flow: stores · Redux-style state manages chatroom, messages, and user data.
- ChatApp → Firebase: uses · Client reads and writes chat data through Firebase.
- ChatApp → Functions: pairs with · Client depends on Firebase Functions backend for server-side logic.
- Recipes app → App shell: boots · Root entrypoints assemble the mobile app.
- Recipes app → Build scripts: builds with · Scripts handle build, bundle, install, and platform updates.
- Recipes app → Extensions: composed of · App is dynamically assembled from extensions.
- Extensions → Navigation: includes · Navigation wraps routing and layout across the app.
- Extensions → CMS: includes · CMS defines schemas and builder-side authoring surfaces.
- Extensions → Loyalty: includes · Loyalty provides points and rewards flows.
- Extensions → Shopify: includes · Shopify provides commerce and checkout.
- Extensions → News: includes · News provides article content experiences.
- Extensions → Media feeds: includes · Media extensions cover RSS, video, photo, and web content.
- Extensions → Favorites: includes · Favorites is shared cross-cutting app state.
- Extensions → Push: includes · Push handles notification permissions and delivery plumbing.
- Extensions → Theme: includes · Theme configures global look and assets.
- HackerNewsApp → HN API: fetches from · Stories, comments, and votes are driven by the HN API helper.
- HackerNewsApp → Store: manages · Central store coordinates the HN reader state.
- MusicApp → Player: plays · Player UI drives the media experience.
- MusicApp → Helpers: integrates · SoundCloud and Flickr helpers support audio and artwork.
- TravelApp → Packing flow: tracks · Packing list state drives the travel workflow.
- CryptoDataVizApp → Graphs: visualizes · Charts and current value views present market data.