Video tutorials for a monorepo: one .ondaclip folder

When you create video tutorials for a monorepo, the first question is simple: one setup per app, or one for the whole repo? Plenty of teams keep several apps side by side: a web dashboard, an admin panel, a mobile app or two. Ondaclip films all of them from a single .ondaclip/ folder at the root.

List the apps in a monorepo in config.yaml

In config.yaml, the products: key lists the apps you want filmed, and only those. Your repo can hold other apps too.

products:
  dashboard:
    name: Dashboard
    freshness: { appPaths: [apps/web/dashboard] }
  staff:
    name: Mobile app
    platform: android
    freshness: { appPaths: [apps/mobile/staff] }

Each product gets its own tutorials folder and its own publication list. Shared settings (languages, voice, environment) live at the top of the file, and each product only overrides what’s different for it.

Each pull request checks the right app

With appPaths, a pull request on the mobile app only checks the mobile app’s tutorials. And the agent that writes a tutorial only reads that app’s code, so it works faster and makes fewer mistakes.

It’s all covered in the .ondaclip folder. To write the first tutorial for each app, follow your first tutorial.