react-native-nitro-xlsx 0.1.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Denis Cheung (https://github.com/zydbkqf)
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/NOTICE

@@ -0,0 +1,73 @@
+OPEN SOURCE SOFTWARE ATTRIBUTION NOTICE
+This software uses third-party open source components listed below, with full license text attached.
+
+================================================================================
+1. OpenXLSX
+Repository: https://github.com/troldal/OpenXLSX
+License: BSD 3-Clause License
+Copyright (c) 2020 Kenneth Troldal Balslev
+
+Full BSD 3-Clause License text:
+
+BSD 3-Clause License
+
+Copyright (c) 2020, Kenneth Troldal Balslev All rights reserved.
+
+Redistribution and use in source and binary forms, with or without modification, are permitted provided that the following conditions are met:
+
+Redistributions of source code must retain the above copyright notice, this list of conditions and the following disclaimer.
+
+Redistributions in binary form must reproduce the above copyright notice, this list of conditions and the following disclaimer in the documentation and/or other materials provided with the distribution.
+
+Neither the name of the copyright holder nor the names of its contributors may be used to endorse or promote products derived from this software without specific prior written permission.
+
+THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
+
+================================================================================
+2. react-native-nitro-modules
+Repository: https://github.com/mrousavy/nitro
+Version: 0.58.3
+License: MIT License
+Copyright (c) 2024 Marc Rousavy
+
+================================================================================
+3. pugixml (OpenXLSX dependency)
+Repository: https://github.com/zeux/pugixml
+License: MIT License
+Copyright (c) 2006-2024 Arseny Kapoulkine
+
+================================================================================
+4. Zippy (OpenXLSX dependency)
+Repository: https://github.com/troldal/Zippy
+License: MIT License
+Copyright (c) 2019 Kenneth Troldal Balslev
+
+================================================================================
+5. miniz (OpenXLSX dependency)
+Repository: https://github.com/richgel999/miniz
+License: MIT License
+Copyright (c) 2013-2014 RAD Game Tools and Valve Software
+Copyright (c) 2010-2014 Rich Geldreich and Tenacious Software LLC
+
+Full standard MIT License text:
+
+MIT License
+
+Copyright (c) 2024 Marc Rousavy
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/NitroXlsx.podspec

@@ -0,0 +1,110 @@
+require "json"
+
+package = JSON.parse(File.read(File.join(__dir__, "package.json")))
+
+Pod::Spec.new do |s|
+  s.name         = "NitroXlsx"
+  s.version      = package["version"]
+  s.summary      = package["description"]
+  s.homepage     = package["homepage"]
+  s.license      = package["license"]
+  s.authors      = package["author"]
+
+  s.platforms    = { :ios => "15.1" }
+  s.source       = { :git => "", :tag => "#{s.version}" }
+
+  s.exclude_files = "cpp/tests/**/*"
+
+  s.source_files = [
+    "cpp/**/*.{h,hpp,cpp}",
+    "OpenXLSX/OpenXLSX/**/*.hpp",
+    "OpenXLSX/OpenXLSX/**/*.cpp",
+    "OpenXLSX/ThirdParty/pugixml/src/**/*.hpp",
+    "OpenXLSX/ThirdParty/pugixml/src/**/*.cpp",
+    "OpenXLSX/OpenXLSX/headers/detail/Zippy.hpp",
+    "OpenXLSX/ThirdParty/miniz/**/*.h",
+    "OpenXLSX/ThirdParty/miniz/**/*.c",
+  ]
+
+  s.private_header_files = [
+    "OpenXLSX/**/*.hpp",
+    "OpenXLSX/**/*.h",
+  ]
+
+  s.dependency "React"
+
+  s.pod_target_xcconfig = {
+    "CLANG_CXX_LANGUAGE_STANDARD" => "c++20",
+    "SWIFT_OBJC_INTEROP_MODE" => "objcxx",
+    "DEFINES_MODULE" => "YES",
+    "SWIFT_INSTALL_OBJC_HEADER" => "NO",
+    "OTHER_CFLAGS" => "$(inherited) -fmodules",
+    "OTHER_CPLUSPLUSFLAGS" => "$(inherited) -fmodules",
+    "HEADER_SEARCH_PATHS" => "$(inherited) ${PODS_TARGET_SRCROOT}/OpenXLSX ${PODS_TARGET_SRCROOT}/OpenXLSX/OpenXLSX ${PODS_TARGET_SRCROOT}/OpenXLSX/OpenXLSX/headers ${PODS_TARGET_SRCROOT}/OpenXLSX/ThirdParty/pugixml/src ${PODS_TARGET_SRCROOT}/OpenXLSX/ThirdParty/miniz",
+  }
+
+  s.user_target_xcconfig = {
+    "OTHER_CFLAGS" => "$(inherited) -fmodules",
+    "OTHER_CPLUSPLUSFLAGS" => "$(inherited) -fmodules",
+    "HEADER_SEARCH_PATHS" => "$(inherited) ${PODS_TARGET_SRCROOT}/OpenXLSX ${PODS_TARGET_SRCROOT}/OpenXLSX/OpenXLSX ${PODS_TARGET_SRCROOT}/OpenXLSX/OpenXLSX/headers ${PODS_TARGET_SRCROOT}/OpenXLSX/ThirdParty/pugixml/src ${PODS_TARGET_SRCROOT}/OpenXLSX/ThirdParty/miniz",
+  }
+
+  s.prepare_command = <<-CMD
+    if [ ! -d "OpenXLSX" ]; then
+      git clone --depth 1 --branch v0.5.1 https://github.com/troldal/OpenXLSX.git
+    fi
+    mkdir -p OpenXLSX/ThirdParty
+    if [ ! -d "OpenXLSX/ThirdParty/pugixml" ]; then
+      git clone --depth 1 --branch v1.15 https://github.com/zeux/pugixml.git OpenXLSX/ThirdParty/pugixml
+    fi
+    if [ ! -d "OpenXLSX/ThirdParty/miniz" ]; then
+      git clone --depth 1 --branch 3.0.2 https://github.com/richgel999/miniz.git OpenXLSX/ThirdParty/miniz
+    fi
+    if [ ! -f "OpenXLSX/ThirdParty/miniz/miniz_export.h" ]; then
+      cat > OpenXLSX/ThirdParty/miniz/miniz_export.h << 'EOF'
+#ifndef MINIZ_EXPORT_H
+#define MINIZ_EXPORT_H
+
+#ifndef MINIZ_EXPORT
+#define MINIZ_EXPORT
+#endif
+
+#ifndef MINIZ_DEPRECATED
+#define MINIZ_DEPRECATED
+#endif
+
+#ifndef MINIZ_DEPRECATED_EXPORT
+#define MINIZ_DEPRECATED_EXPORT MINIZ_EXPORT MINIZ_DEPRECATED
+#endif
+
+#ifndef MINIZ_NO_EXPORT
+#define MINIZ_NO_EXPORT
+#endif
+
+#endif
+EOF
+    fi
+    if [ ! -f "OpenXLSX/OpenXLSX/headers/OpenXLSX-Exports.hpp" ]; then
+      cat > OpenXLSX/OpenXLSX/headers/OpenXLSX-Exports.hpp << 'EOF'
+#ifndef OPENXLSX_EXPORTS_HPP
+#define OPENXLSX_EXPORTS_HPP
+
+#ifndef OPENXLSX_EXPORT
+#define OPENXLSX_EXPORT
+#endif
+
+#ifndef OPENXLSX_HIDDEN
+#define OPENXLSX_HIDDEN
+#endif
+
+#endif
+EOF
+    fi
+    if [ ! -d "OpenXLSX/OpenXLSX/headers/OpenXLSX" ]; then
+      cd OpenXLSX/OpenXLSX/headers && ln -sf . OpenXLSX && cd -
+    fi
+  CMD
+
+  load 'nitrogen/generated/ios/NitroXlsx+autolinking.rb'
+  add_nitrogen_files(s)
+end

package/README.md

@@ -0,0 +1,340 @@
+# react-native-nitro-xlsx
+
+A React Native module for reading and writing Excel XLSX files using [OpenXLSX](https://github.com/troldal/OpenXLSX) via [react-native-nitro-modules](https://github.com/mrousavy/nitro).
+
+## Features
+
+- 📊 Full Excel XLSX file creation support
+- 📖 Read existing XLSX files (from file path or buffer)
+- 📝 Formula support (with default values)
+- 📅 Date/DateTime support
+- 🖼️ Image insertion (from file path or buffer)
+- 🎨 Rich formatting (fonts, colors, borders, alignment)
+- 📄 Page setup (margins, orientation, headers/footers)
+- 🔒 Sheet protection
+- 📦 Export as ArrayBuffer - no file system required!
+
+## Installation
+
+```sh
+npm install react-native-nitro-xlsx
+# or
+yarn add react-native-nitro-xlsx
+```
+
+### iOS
+
+```sh
+cd ios && pod install
+```
+
+### Android
+
+No additional setup needed.
+
+## Usage
+
+### Creating a Workbook
+
+```typescript
+import { NitroXlsx, Align, Colors, NumFormat } from 'react-native-nitro-xlsx';
+
+// Create a new workbook (no file path needed!)
+const workbook = NitroXlsx.createWorkbook();
+
+// Add a worksheet
+const sheet = workbook.addWorksheet('Sheet1');
+
+// Create a cell format for headers
+const headerFormat = workbook.addCellFormat();
+headerFormat.setBold();
+headerFormat.setFontColor(Colors.WHITE);
+headerFormat.setFgColor(Colors.BLUE);
+headerFormat.setAlign(Align.CENTER);
+
+// Write headers
+sheet.writeString(0, 0, 'Name', headerFormat);
+sheet.writeString(0, 1, 'Price', headerFormat);
+sheet.writeString(0, 2, 'Total', headerFormat);
+
+// Write data
+sheet.writeString(1, 0, 'Apple');
+sheet.writeNumber(1, 1, 1.50);
+sheet.writeFormula(1, 2, '=B2*1.1');
+
+sheet.writeString(2, 0, 'Orange');
+sheet.writeNumber(2, 1, 2.00);
+sheet.writeFormula(2, 2, '=B3*1.1');
+
+// Date example
+const date = new Date(2024, 0, 15);
+const excelDate = (date.getTime() / 86400000) + 25569; // Convert to Excel date
+sheet.writeDatetime(3, 0, excelDate);
+
+// Set column widths
+sheet.setColumn(0, 0, 15);
+sheet.setColumn(1, 2, 12);
+
+// Get the buffer and do something with it
+const buffer = await workbook.getBuffer();
+
+// Save to file system, share, upload, etc.
+// Example: FileSystem.writeAsStringAsync(path, buffer.toString('base64'));
+// Example: Share.open({ url: 'data:application/vnd.openxmlformats-officedocument.spreadsheetml.sheet;base64,' + btoa(buffer) });
+```
+
+### Reading a Workbook
+
+```typescript
+import { NitroXlsx } from 'react-native-nitro-xlsx';
+
+// Open workbook from file path
+const workbook = NitroXlsx.openWorkbook('/path/to/file.xlsx');
+
+// Or open from buffer
+// const workbook = NitroXlsx.openWorkbookFromBuffer(arrayBuffer);
+
+// Get worksheet
+const sheet = workbook.getWorksheet(0);
+const sheetByName = workbook.getWorksheetByName('Sheet1');
+
+// Get worksheet info
+const name = sheet.getName();
+const lastRow = sheet.getLastRow();
+const lastCol = sheet.getLastColumn();
+
+// Read cell values
+for (let row = 0; row <= lastRow; row++) {
+  for (let col = 0; col <= lastCol; col++) {
+    const value = sheet.getCellValue(row, col);
+    const type = sheet.getCellType(row, col);
+    const strValue = sheet.getCellString(row, col);
+    console.log(`Cell [${row},${col}]: ${value} (type: ${type})`);
+  }
+}
+
+// Read cell format
+const format = sheet.getCellFormat(0, 0);
+const isBold = format.getIsBold();
+const fontName = format.getFontName();
+const fontSize = format.getFontSize();
+```
+
+## API
+
+### NitroXlsx
+
+- `createWorkbook(): XlsxWorkbook` - Create a new workbook
+- `openWorkbook(path: string): XlsxWorkbook` - Open workbook from file path
+- `openWorkbookFromBuffer(buffer: ArrayBuffer): XlsxWorkbook` - Open workbook from buffer
+
+### XlsxWorkbook
+
+- `addWorksheet(name?: string): XlsxWorksheet` - Add a new worksheet
+- `getWorksheet(index: number): XlsxWorksheet` - Get worksheet by index
+- `getWorksheetByName(name: string): XlsxWorksheet` - Get worksheet by name
+- `getOrAddWorksheet(name: string): XlsxWorksheet` - Get or add worksheet
+- `getWorksheetCount(): number` - Get number of worksheets
+- `addCellFormat(): XlsxCellFormat` - Add a new cell format
+- `getBuffer(): Promise<ArrayBuffer>` - Generate and return the XLSX file as a buffer
+
+### XlsxWorksheet
+
+#### Basic Write Methods
+| Method | Description |
+|--------|-------------|
+| `writeString(row, col, value, format?)` | Write a string |
+| `writeNumber(row, col, value, format?)` | Write a number |
+| `writeBoolean(row, col, value, format?)` | Write a boolean |
+| `writeBlank(row, col, format?)` | Write a blank cell |
+
+#### Formula Support
+| Method | Description |
+|--------|-------------|
+| `writeFormula(row, col, formula, format?)` | Write a formula |
+| `writeFormulaNum(row, col, formula, number, format?)` | Write a formula with number default |
+| `writeFormulaString(row, col, formula, string, format?)` | Write a formula with string default |
+| `writeFormulaBoolean(row, col, formula, boolean, format?)` | Write a formula with boolean default |
+| `writeArrayFormula(firstRow, firstCol, lastRow, lastCol, formula, format?)` | Write an array formula |
+
+#### Date/URL
+| Method | Description |
+|--------|-------------|
+| `writeDatetime(row, col, datetime, format?)` | Write a datetime (Excel serial date number) |
+| `writeURL(row, col, url, format?)` | Write a hyperlink |
+
+#### Column/Row
+| Method | Description |
+|--------|-------------|
+| `setColumn(firstCol, lastCol, width, format?)` | Set column properties |
+| `setRow(row, height, format?)` | Set row properties |
+| `setColumnHidden(firstCol, lastCol, hidden)` | Hide/show columns |
+| `setRowHidden(row, hidden)` | Hide/show row |
+
+#### Merge
+| Method | Description |
+|--------|-------------|
+| `mergeRange(firstRow, firstCol, lastRow, lastCol, value, format?)` | Merge cells with string value |
+| `mergeRangeNum(firstRow, firstCol, lastRow, lastCol, value, format?)` | Merge cells with number value |
+
+#### Image
+| Method | Description |
+|--------|-------------|
+| `insertImage(row, col, path, xOffset?, yOffset?, xScale?, yScale?)` | Insert image from file |
+| `insertImageBuffer(row, col, buffer, extension, xOffset?, yOffset?, xScale?, yScale?)` | Insert image from buffer |
+
+#### View
+| Method | Description |
+|--------|-------------|
+| `freezePanes(row, col)` | Freeze panes |
+| `splitPanes(row, col)` | Split panes |
+| `setTabColor(color)` | Set tab color |
+| `hide()` | Hide worksheet |
+| `activate()` | Activate worksheet |
+| `setFirstSheet()` | Set as first sheet |
+| `protect(password?)` | Protect worksheet |
+
+#### Page Setup
+| Method | Description |
+|--------|-------------|
+| `setPortrait()` | Set portrait orientation |
+| `setLandscape()` | Set landscape orientation |
+| `setPaper(paperType)` | Set paper size |
+| `setHeader(header)` | Set header |
+| `setFooter(footer)` | Set footer |
+| `setPrintArea(firstRow, firstCol, lastRow, lastCol)` | Set print area |
+| `fitToPages(width, height)` | Fit to pages |
+| `setZoom(scale)` | Set zoom level |
+| `setGridlines(option)` | Set gridlines |
+| `centerHorizontally()` | Center horizontally |
+| `centerVertically()` | Center vertically |
+
+#### Read Methods
+| Method | Description |
+|--------|-------------|
+| `getCellValue(row, col)` | Get cell value (string \| number \| boolean \| null) |
+| `getCellString(row, col)` | Get cell value as string |
+| `getCellRawValue(row, col)` | Get raw cell value |
+| `getCellType(row, col)` | Get cell type |
+| `getCellFormat(row, col)` | Get cell format |
+| `getRowCount()` | Get total row count |
+| `getColumnCount()` | Get total column count |
+| `getLastRow()` | Get last row index |
+| `getLastColumn()` | Get last column index |
+| `getName()` | Get worksheet name |
+
+### XlsxCellFormat
+
+The `XlsxCellFormat` interface is based on OpenXLSX's `XLCellFormat` class and provides rich cell formatting capabilities.
+
+#### Font
+- `setFontName(name)`, `setFontSize(size)`, `setFontColor(color)`
+- `setBold()`, `setItalic()`, `setUnderline(style?)`, `setStrikeout()`
+- `setFontScript(style)` - Superscript/subscript
+
+#### Alignment
+- `setAlign(align)`, `setVerticalAlign(align)`
+- `setTextWrap()`, `setRotation(angle)`
+- `setIndent(level)`, `setShrink()`
+
+#### Number Format
+- `setNumFormat(format)` - Set custom format string
+- `setNumFormatIndex(index)` - Set built-in format (use `NumFormat` constants)
+
+#### Colors/Pattern
+- `setBgColor(color)`, `setFgColor(color)`
+- `setPattern(pattern)`
+
+#### Borders
+- `setBorder(style)`, `setBorderColor(color)`
+- `setTop/Botton/Left/Right(style)`, `setTopColor/BottomColor/LeftColor/RightColor(color)`
+- `setDiagonal(style)`, `setDiagonalColor(color)`
+
+#### Protection
+- `setLocked()`, `setUnlocked()`
+
+#### Other
+- `setHyperlink()`, `setFontOnly()`
+
+#### Read Properties
+- `getFontName()` - Get font name
+- `getFontSize()` - Get font size
+- `getFontColor()` - Get font color
+- `getIsBold()` - Check if bold
+- `getIsItalic()` - Check if italic
+- `getNumFormat()` - Get number format
+- `getBgColor()` - Get background color
+
+## Cell Types
+
+When reading cells, the following types are returned:
+
+- `empty` - Empty cell
+- `string` - Text string
+- `number` - Numeric value
+- `boolean` - Boolean value
+- `date` - Date/time value
+- `error` - Error value
+- `formula` - Formula
+- `blank` - Blank cell
+
+## Constants
+
+The library exports several useful constants:
+
+- `Align` - Cell alignment values
+- `VAlign` - Vertical alignment values
+- `Border` - Border styles
+- `Underline` - Underline styles
+- `Script` - Superscript/subscript
+- `Pattern` - Fill patterns
+- `Paper` - Paper sizes
+- `Gridlines` - Gridline options
+- `Colors` - Common RGB colors
+- `NumFormat` - Built-in number format indices
+- `ImagePosition` - Image positioning options
+
+## Development
+
+To regenerate the native specs after modifying the TypeScript spec files:
+
+```sh
+npx nitrogen
+```
+
+## License
+
+This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.
+
+Third-party open source attributions are listed in the [NOTICE](NOTICE) file.
+
+## Acknowledgements
+
+This library wraps the excellent [OpenXLSX](https://github.com/troldal/OpenXLSX) library, a modern C++ library for reading and writing Excel XLSX files.
+
+## Known Limitations
+
+This library is based on OpenXLSX and inherits the following limitations:
+
+### Unsupported Formats
+
+- **XLS format**: Only XLSX (Office Open XML) format is supported. Legacy XLS (Binary) format is not supported.
+
+### Unsupported Features
+
+The following Excel features are not supported and will be ignored when reading or writing files:
+
+- 🖼️ **Images**: Reading and writing images is not supported. Existing images in XLSX files will be ignored.
+- 📊 **Charts**: Charts, graphs, and sparklines are not supported.
+- ✏️ **Drawings/Shape**: Shapes, lines, arrows, and other drawing objects are not supported.
+- 🔍 **Pivot Tables**: Pivot tables and pivot charts are not supported.
+- 💻 **VBA/Macros**: VBA macros, forms, and ActiveX controls are not supported.
+- 📋 **Comments**: Cell comments and notes are not supported.
+- 📌 **Hyperlinks**: Only basic URL hyperlinks are supported.
+- 🔄 **Conditional Formatting**: Conditional formatting rules are not supported.
+- 📑 **Data Validation**: Data validation rules are not supported.
+
+### Notes
+
+- When reading XLSX files that contain unsupported features, the library will still read the cell data and formatting, but unsupported elements will be silently ignored.
+- When writing XLSX files, unsupported features cannot be added and will be omitted from the output.

package/android/CMakeLists.txt

@@ -0,0 +1,52 @@
+cmake_minimum_required(VERSION 3.22.1)
+project("NitroXlsx")
+
+set(CMAKE_CXX_STANDARD 20)
+set(CMAKE_CXX_STANDARD_REQUIRED ON)
+
+set(OPENXLSX_DIR ${CMAKE_SOURCE_DIR}/../OpenXLSX)
+if(NOT EXISTS ${OPENXLSX_DIR}/CMakeLists.txt)
+  include(FetchContent)
+  FetchContent_Declare(
+    OpenXLSX
+    GIT_REPOSITORY https://github.com/troldal/OpenXLSX.git
+    GIT_TAG v0.5.1
+  )
+  FetchContent_GetProperties(OpenXLSX)
+  if(NOT OpenXLSX_POPULATED)
+    FetchContent_Populate(OpenXLSX)
+  endif()
+  set(OPENXLSX_DIR ${openxlsx_SOURCE_DIR})
+endif()
+
+set(OPENXLSX_BUILD_SAMPLES OFF CACHE BOOL "" FORCE)
+set(OPENXLSX_BUILD_TESTS OFF CACHE BOOL "" FORCE)
+set(OPENXLSX_BUILD_BENCHMARKS OFF CACHE BOOL "" FORCE)
+set(OPENXLSX_CREATE_DOCS OFF CACHE BOOL "" FORCE)
+set(BUILD_SHARED_LIBS OFF CACHE BOOL "" FORCE)
+
+add_subdirectory(${OPENXLSX_DIR} OpenXLSX_build)
+
+add_library(
+  NitroXlsx
+  SHARED
+  ../cpp/HybridNitroXlsx.cpp
+  ../cpp/HybridXlsxWorkbook.cpp
+  ../cpp/HybridXlsxWorksheet.cpp
+  ../cpp/HybridXlsxCellFormat.cpp
+  cpp-adapter.cpp
+)
+
+target_include_directories(
+  NitroXlsx
+  PRIVATE
+  ../cpp
+  ${OPENXLSX_DIR}
+  ${OPENXLSX_DIR}/OpenXLSX/headers
+)
+
+target_link_libraries(NitroXlsx OpenXLSX)
+
+target_link_options(NitroXlsx PRIVATE -Wl,--unresolved-symbols=ignore-all)
+
+include(${CMAKE_SOURCE_DIR}/../nitrogen/generated/android/NitroXlsx+autolinking.cmake)

package/android/build.gradle

@@ -0,0 +1,49 @@
+buildscript {
+  ext.safeExtGet = {prop, fallback ->
+    rootProject.ext.has(prop) ? rootProject.ext.get(prop) : fallback
+  }
+}
+
+apply plugin: 'com.android.library'
+apply plugin: 'kotlin-android'
+
+android {
+  namespace "com.margelo.nitro.xlsx"
+  compileSdk safeExtGet("compileSdkVersion", 34)
+
+  defaultConfig {
+    minSdk safeExtGet("minSdkVersion", 21)
+    externalNativeBuild {
+      cmake {
+        arguments "-DANDROID_STL=c++_shared"
+      }
+    }
+  }
+
+  buildFeatures {
+    buildConfig false
+    prefab true
+  }
+
+  compileOptions {
+    sourceCompatibility JavaVersion.VERSION_17
+    targetCompatibility JavaVersion.VERSION_17
+  }
+
+  kotlinOptions {
+    jvmTarget = "17"
+  }
+
+  externalNativeBuild {
+    cmake {
+      path file("CMakeLists.txt")
+    }
+  }
+}
+
+dependencies {
+  implementation "com.facebook.react:react-native:+"
+  implementation project(':react-native-nitro-modules')
+}
+
+apply from: "../nitrogen/generated/android/NitroXlsx+autolinking.gradle"

package/android/cpp-adapter.cpp

@@ -0,0 +1,9 @@
+#include <jni.h>
+#include <fbjni/fbjni.h>
+#include "NitroXlsxOnLoad.hpp"
+
+JNIEXPORT jint JNICALL JNI_OnLoad(JavaVM* vm, void*) {
+  return facebook::jni::initialize(vm, []() {
+    margelo::nitro::xlsx::registerAllNatives();
+  });
+}

package/android/src/main/AndroidManifest.xml

@@ -0,0 +1,2 @@
+<manifest xmlns:android="http://schemas.android.com/apk/res/android">
+</manifest>

package/android/src/main/java/com/margelo/nitro/xlsx/NitroXlsxPackage.kt

@@ -0,0 +1,22 @@
+package com.margelo.nitro.xlsx
+
+import com.facebook.react.ReactPackage
+import com.facebook.react.bridge.ReactApplicationContext
+import com.facebook.react.bridge.NativeModule
+import com.facebook.react.uimanager.ViewManager
+
+class NitroXlsxPackage : ReactPackage {
+  companion object {
+    init {
+      NitroXlsxOnLoad.initializeNative()
+    }
+  }
+
+  override fun createNativeModules(reactContext: ReactApplicationContext): List<NativeModule> {
+    return emptyList()
+  }
+
+  override fun createViewManagers(reactContext: ReactApplicationContext): List<ViewManager<*, *>> {
+    return emptyList()
+  }
+}