feat: option to add nitro views

.github/workflows/build-templates.yml

@@ -35,6 +35,8 @@ jobs:
             language: kotlin-objc
           - name: nitro-module
             language: kotlin-swift
+          - name: nitro-view
+            language: kotlin-swift
         include:
           - os: ubuntu-latest
             type:
@@ -140,6 +142,11 @@ jobs:
             fi
           fi
 
+      - name: Generate nitrogen code
+        if: matrix.type == 'nitro-view' || matrix.type == 'nitro-module'
+        working-directory: ${{ env.work_dir }}
+        run: yarn nitrogen
+
       - name: Cache turborepo
         if: env.android_build == 1 || env.ios_build == 1
         uses: actions/cache@v4

packages/create-react-native-library/src/constants.ts

@@ -1,3 +1,3 @@
 export const FALLBACK_BOB_VERSION = '0.40.8';
-export const FALLBACK_NITRO_MODULES_VERSION = '0.25.2';
+export const FALLBACK_NITRO_MODULES_VERSION = '0.26.2';
 export const SUPPORTED_REACT_NATIVE_VERSION = '0.79.2';

packages/create-react-native-library/src/exampleApp/generateExampleApp.ts

@@ -196,7 +196,10 @@ export default async function generateExampleApp({
     'react-native-monorepo-config': `^0.1.9`,
   };
 
-  if (config.project.moduleConfig === 'nitro-modules') {
+  if (
+    config.project.moduleConfig === 'nitro-modules' ||
+    config.project.viewConfig === 'nitro-view'
+  ) {
     const packagesToAddNitro = {
       'react-native-nitro-modules': `^${config.versions.nitro || 'latest'}`,
     };

packages/create-react-native-library/src/index.ts

@@ -72,9 +72,8 @@ async function create(_argv: Args) {
   });
 
   const bobVersion = await bobVersionPromise;
-
   const nitroModulesVersion =
-    answers.type === 'nitro-module'
+    answers.type === 'nitro-module' || answers.type === 'nitro-view'
       ? await nitroModulesVersionPromise
       : undefined;
 

packages/create-react-native-library/src/input.ts

@@ -14,6 +14,7 @@ export type ProjectType =
   | 'turbo-module'
   | 'fabric-view'
   | 'nitro-module'
+  | 'nitro-view'
   | 'library';
 
 const LANGUAGE_CHOICES: {
@@ -24,7 +25,7 @@ const LANGUAGE_CHOICES: {
   {
     title: 'Kotlin & Swift',
     value: 'kotlin-swift',
-    types: ['nitro-module'],
+    types: ['nitro-module', 'nitro-view'],
   },
   {
     title: 'Kotlin & Objective-C',
@@ -84,6 +85,12 @@ const TYPE_CHOICES: {
     description:
       'type-safe, fast integration for native APIs to JS (experimental)',
   },
+  {
+    title: 'Nitro view',
+    value: 'nitro-view',
+    description:
+      'integration for native views to JS using nitro for prop parsing (experimental)',
+  },
   {
     title: 'JavaScript library',
     value: 'library',

packages/create-react-native-library/src/template.ts

@@ -14,7 +14,7 @@ export type ModuleConfig =
   | 'nitro-modules'
   | null;
 
-export type ViewConfig = 'paper-view' | 'fabric-view' | null;
+export type ViewConfig = 'paper-view' | 'fabric-view' | 'nitro-view' | null;
 
 // Please think at least 5 times before introducing a new config key
 // You can just reuse the existing ones most of the time
@@ -76,6 +76,7 @@ const NATIVE_FILES = {
   module_new: path.resolve(__dirname, '../templates/native-library-new'),
   view_new: path.resolve(__dirname, '../templates/native-view-new'),
   module_nitro: path.resolve(__dirname, '../templates/nitro-module'),
+  view_nitro: path.resolve(__dirname, '../templates/nitro-view'),
 } as const;
 
 const OBJC_FILES = {
@@ -155,6 +156,7 @@ function getModuleConfig(projectType: ProjectType): ModuleConfig {
       return 'turbo-modules';
     case 'fabric-view':
     case 'library':
+    case 'nitro-view':
       return null;
   }
 }
@@ -163,9 +165,12 @@ function getViewConfig(projectType: ProjectType): ViewConfig {
   switch (projectType) {
     case 'fabric-view':
       return 'fabric-view';
+    case 'nitro-view':
+      return 'nitro-view';
     case 'nitro-module':
     case 'turbo-module':
     case 'library':
+    default:
       return null;
   }
 }
@@ -208,6 +213,11 @@ export async function applyTemplates(
       return;
     }
 
+    if (config.project.viewConfig === 'nitro-view') {
+      await applyTemplate(config, NATIVE_FILES['view_nitro'], folder);
+      return;
+    }
+
     if (config.project.moduleConfig !== null) {
       await applyTemplate(config, NATIVE_FILES[`module_new`], folder);
     } else {

packages/create-react-native-library/templates/common/$.github/workflows/ci.yml

@@ -61,7 +61,7 @@ jobs:
 
       - name: Setup
         uses: ./.github/actions/setup
-<% if (project.moduleConfig === 'nitro-modules') { -%>
+<% if (project.moduleConfig === 'nitro-modules' || project.viewConfig === 'nitro-view') { -%>
 
       - name: Generate nitrogen code
         run: yarn nitrogen
@@ -123,7 +123,7 @@ jobs:
 
       - name: Setup
         uses: ./.github/actions/setup
-<% if (project.moduleConfig === 'nitro-modules') { -%>
+<% if (project.moduleConfig === 'nitro-modules' || project.viewConfig === 'nitro-view') { -%>
 
       - name: Generate nitrogen code
         run: yarn nitrogen

packages/create-react-native-library/templates/common/$package.json

@@ -48,7 +48,7 @@
     "clean": "del-cli lib",
 <% } -%>
     "prepare": "bob build",
-<% if (project.moduleConfig === 'nitro-modules') { -%>
+<% if (project.moduleConfig === 'nitro-modules' || project.viewConfig === 'nitro-view') { -%>
     "nitrogen": "nitro-codegen",
 <% } -%>
     "release": "release-it --only-version"
@@ -91,14 +91,14 @@
     "eslint-config-prettier": "^10.1.1",
     "eslint-plugin-prettier": "^5.2.3",
     "jest": "^29.7.0",
-<% if (project.moduleConfig === 'nitro-modules') { -%>
+<% if (project.moduleConfig === 'nitro-modules' || project.viewConfig === 'nitro-view') { -%>
     "nitro-codegen": "^<%- versions.nitro %>",
 <% } -%>
     "prettier": "^3.0.3",
     "react": "19.0.0",
     "react-native": "0.78.1",
     "react-native-builder-bob": "^<%- versions.bob %>",
-<% if (project.moduleConfig === 'nitro-modules') { -%>
+<% if (project.moduleConfig === 'nitro-modules' || project.viewConfig === 'nitro-view') { -%>
     "react-native-nitro-modules": "^<%- versions.nitro %>",
 <% } -%>
     "release-it": "^17.10.0",
@@ -109,7 +109,7 @@
   },
   "peerDependencies": {
     "react": "*",
-<% if (project.moduleConfig === 'nitro-modules') { -%>
+<% if (project.moduleConfig === 'nitro-modules' || project.viewConfig === 'nitro-view') { -%>
     "react-native": "*",
     "react-native-nitro-modules": "^<%- versions.nitro %>"
 <% } else { -%>
@@ -164,7 +164,7 @@
     "source": "src",
     "output": "lib",
     "targets": [
-<% if (project.moduleConfig === "nitro-modules") { -%>
+<% if (project.moduleConfig === "nitro-modules" || project.viewConfig === "nitro-view") { -%>
       [
         "custom",
         {

packages/create-react-native-library/templates/common/CONTRIBUTING.md

@@ -19,7 +19,7 @@ yarn
 
 > Since the project relies on Yarn workspaces, you cannot use [`npm`](https://github.com/npm/cli) for development.
 
-<% if (project.moduleConfig === 'nitro-modules') { -%>
+<% if (project.moduleConfig === 'nitro-modules' || project.viewConfig === 'nitro-view') { -%>
 This project uses Nitro Modules. If you're not familiar with how Nitro works, make sure to check the [Nitro Modules Docs](https://nitro.margelo.com/).
 
 You need to run [Nitrogen](https://nitro.margelo.com/docs/nitrogen) to generate the boilerplate code required for this project. The example app will not build without this step.

packages/create-react-native-library/templates/common/README.md

@@ -4,16 +4,20 @@
 
 ## Installation
 
-<% if (project.moduleConfig === 'nitro-modules') { -%>
+<% if (project.moduleConfig === 'nitro-modules' || project.viewConfig === 'nitro-view') { -%>
+
 ```sh
 npm install <%- project.slug %> react-native-nitro-modules
 
 > `react-native-nitro-modules` is required as this library relies on [Nitro Modules](https://nitro.margelo.com/).
 ```
+
 <% } else { -%>
+
 ```sh
 npm install <%- project.slug %>
 ```
+
 <% } -%>
 
 ## Usage
@@ -28,7 +32,7 @@ import { <%- project.name -%>View } from "<%- project.slug -%>";
 <<%- project.name -%>View color="tomato" />
 ```
 
-<% } else if (project.moduleConfig === 'nitro-modules' || project.moduleConfig === 'turbo-modules') { -%>
+<% } else if (project.moduleConfig === 'nitro-modules' || project.viewConfig === 'nitro-view' || project.moduleConfig === 'turbo-modules') { -%>
 
 ```js
 import { multiply } from '<%- project.slug -%>';

packages/create-react-native-library/templates/native-common/android/build.gradle

@@ -15,7 +15,7 @@ buildscript {
   }
 }
 
-<% if (project.moduleConfig === 'nitro-modules') { -%>
+<% if (project.cpp || project.moduleConfig === 'nitro-modules' || project.viewConfig === 'nitro-view') { -%>
 def reactNativeArchitectures() {
   def value = rootProject.getProperties().get("reactNativeArchitectures")
   return value ? value.split(",") : ["armeabi-v7a", "x86", "x86_64", "arm64-v8a"]
@@ -24,7 +24,7 @@ def reactNativeArchitectures() {
 
 apply plugin: "com.android.library"
 apply plugin: "kotlin-android"
-<% if (project.moduleConfig === 'nitro-modules') { -%>
+<% if (project.moduleConfig === 'nitro-modules' || project.viewConfig === 'nitro-view') { -%>
 apply from: '../nitrogen/generated/android/<%- project.package_cpp -%>+autolinking.gradle'
 <% } -%>
 
@@ -35,7 +35,7 @@ def getExtOrIntegerDefault(name) {
 }
 
 android {
-<% if (project.moduleConfig === 'nitro-modules') { -%>
+<% if (project.moduleConfig === 'nitro-modules' || project.viewConfig === 'nitro-view') { -%>
   namespace "com.margelo.nitro.<%- project.package -%>"
 <% } else { -%>
   namespace "com.<%- project.package -%>"
@@ -46,7 +46,7 @@ android {
   defaultConfig {
     minSdkVersion getExtOrIntegerDefault("minSdkVersion")
     targetSdkVersion getExtOrIntegerDefault("targetSdkVersion")
-<% if (project.moduleConfig === 'nitro-modules') { -%>
+<% if (project.cpp || project.moduleConfig === 'nitro-modules' || project.viewConfig === 'nitro-view') { -%>
 
     externalNativeBuild {
       cmake {
@@ -66,15 +66,15 @@ android {
     }
 <% } -%>
   }
-<% if (project.moduleConfig === 'nitro-modules') { -%>
+<% if (project.cpp || project.moduleConfig === 'nitro-modules' || project.viewConfig === 'nitro-view') { -%>
 
   externalNativeBuild {
     cmake {
       path "CMakeLists.txt"
     }
   }
 <% } -%>
-<% if (project.moduleConfig === 'nitro-modules') { -%>
+<% if (project.moduleConfig === 'nitro-modules' || project.viewConfig === 'nitro-view') { -%>
 
   packagingOptions {
     excludes = [
@@ -100,7 +100,7 @@ android {
 
   buildFeatures {
     buildConfig true
-<% if (project.moduleConfig === 'nitro-modules') { -%>
+<% if (project.moduleConfig === 'nitro-modules' || project.viewConfig === 'nitro-view') { -%>
     prefab true
 <% } -%>
   }
@@ -140,7 +140,7 @@ def kotlin_version = getExtOrDefault("kotlinVersion")
 dependencies {
   implementation "com.facebook.react:react-android"
   implementation "org.jetbrains.kotlin:kotlin-stdlib:$kotlin_version"
-<% if (project.moduleConfig === 'nitro-modules') { -%>
+<% if (project.moduleConfig === 'nitro-modules' || project.viewConfig === 'nitro-view') { -%>
   implementation project(":react-native-nitro-modules")
 <% } -%>
 }

packages/create-react-native-library/templates/native-common/{%- project.name %}.podspec

@@ -13,7 +13,7 @@ Pod::Spec.new do |s|
   s.platforms    = { :ios => min_ios_version_supported }
   s.source       = { :git => "<%- repo -%>.git", :tag => "#{s.version}" }
 
-<% if (project.moduleConfig !== "nitro-modules") { -%>
+<% if (project.moduleConfig !== "nitro-modules" || project.viewConfig === "nitro-view") { -%>
 <% if (project.swift) { -%>
   s.source_files = "ios/**/*.{h,m,mm,swift}"
 <% } else { -%>
@@ -22,7 +22,7 @@ Pod::Spec.new do |s|
 <% } -%>
 <% } -%>
 
-<% if (project.moduleConfig === "nitro-modules") { -%>
+<% if (project.moduleConfig === "nitro-modules" || project.viewConfig === "nitro-view") { -%>
   s.source_files = [
     "ios/**/*.{swift}",
     "ios/**/*.{m,mm}",

packages/create-react-native-library/templates/nitro-module/android/src/main/java/com/{%- project.package_dir %}/{%- project.name %}Package.kt

@@ -1,4 +1,4 @@
-package com.<%- project.package %>
+package com.margelo.nitro.<%- project.package %>
 
 import com.facebook.react.TurboReactPackage
 import com.facebook.react.bridge.NativeModule

packages/create-react-native-library/templates/nitro-view/android/CMakeLists.txt

@@ -0,0 +1,24 @@
+project(<%- project.package_cpp -%>)
+cmake_minimum_required(VERSION 3.9.0)
+
+set(PACKAGE_NAME <%- project.package_cpp -%>)
+set(CMAKE_VERBOSE_MAKEFILE ON)
+set(CMAKE_CXX_STANDARD 20)
+
+# Define C++ library and add all sources
+add_library(${PACKAGE_NAME} SHARED src/main/cpp/cpp-adapter.cpp)
+
+# Add Nitrogen specs :)
+include(${CMAKE_SOURCE_DIR}/../nitrogen/generated/android/<%- project.package_cpp -%>+autolinking.cmake)
+
+# Set up local includes
+include_directories("src/main/cpp" "../cpp")
+
+find_library(LOG_LIB log)
+
+# Link all libraries together
+target_link_libraries(
+        ${PACKAGE_NAME}
+        ${LOG_LIB}
+        android # <-- Android core
+)

packages/create-react-native-library/templates/nitro-view/android/src/main/cpp/cpp-adapter.cpp

@@ -0,0 +1,6 @@
+#include <jni.h>
+#include "<%- project.package_cpp -%>OnLoad.hpp"
+
+JNIEXPORT jint JNICALL JNI_OnLoad(JavaVM* vm, void*) {
+  return margelo::nitro::<%- project.package_cpp -%>::initialize(vm);
+}

packages/create-react-native-library/templates/nitro-view/android/src/main/java/com/margelo/nitro/{%- project.package_dir %}/{%- project.name %}.kt

@@ -0,0 +1,23 @@
+package com.margelo.nitro.<%- project.package %>
+
+import android.view.View
+import com.facebook.proguard.annotations.DoNotStrip
+import com.facebook.react.uimanager.ThemedReactContext
+import androidx.core.graphics.toColorInt
+
+@DoNotStrip
+class Hybrid<%- project.name %>(val context: ThemedReactContext) : Hybrid<%- project.name %>Spec() {
+
+  // View
+  override val view: View = View(context)
+
+  // Props
+  private var _color = "#000"
+  override var color: String
+      get() = _color
+      set(value) {
+          _color = value
+          val color = value.toColorInt()
+          view.setBackgroundColor(color)
+      }
+}