build-nitro-modules

What problem does it solve?

Building cross-platform React Native native modules with Nitrogen involves many manual, error-prone steps: scaffolding a monorepo package, authoring .nitro.ts HybridObject specs, configuring nitro.json autolinking, running the Nitrogen codegen, implementing platform-specific native code (Swift/Kotlin/C++), wiring an example app, and preparing the package for npm publishing. This Skill codifies the full end-to-end workflow, guidance, and common fixes so maintainers can produce reliable, autolinkable Nitro modules without guessing path and configuration details.

Core Features & Use Cases

• Monorepo scaffolding & workspace wiring: Step-by-step guidance to scaffold a package into packages/<name>, add example app, and set root workspaces.
• Spec authoring & codegen: Instructions for writing .nitro.ts HybridObject specs, configuring nitro.json autolinking, and running npx nitrogen to generate native specs.
• Native implementation patterns: Platform-specific implementation best practices and pitfalls for C++, Kotlin, and Swift, plus how to register and include files in build systems.
• Example app & troubleshooting: How to create and wire an example app, fix Metro and Android Gradle paths, align versions, and run the example for validation.
• Publishing readiness: Checklist for package.json files, inclusion of generated native glue code, podspecs, and npm pack verification.

Quick Start

Scaffold a new Nitro module in a monorepo, write the .nitro.ts spec, run Nitrogen to generate native specs, implement the native methods for your chosen platforms, wire an example app, and prepare package metadata for npm publishing.