docs.sheetjs.com/docz/docs/03-demos/17-mobile/05-capacitor.md

title	sidebar_label	pagination_prev	pagination_next	sidebar_position	sidebar_custom_props
Storing Sheets with CapacitorJS	CapacitorJS	demos/static/index	demos/desktop/index	5	summary JS + Web View

import current from '/version.js'; import CodeBlock from '@theme/CodeBlock';

CapacitorJS is a mobile app runtime for building iOS and Android apps.

SheetJS is a JavaScript library for reading and writing data from spreadsheets.

This demo uses CapacitorJS and SheetJS to process data and export spreadsheets. We'll explore how to load SheetJS in an CapacitorJS app and use APIs and plugins to extract data from, and write data to, spreadsheet files on the device.

The "Demo" creates an app that looks like the screenshots below:

iOS	Android

:::note Tested Deployments

This demo was tested in the following environments:

Real Devices

OS	Device	CapacitorJS + FS	Date
Android 30	NVIDIA Shield	6.2.0 / 6.0.3	2025-01-19
iOS 15.1	iPad Pro	6.2.0 / 6.0.3	2025-01-19

Simulators

OS	Device	CapacitorJS + FS	Dev Platform	Date
Android 35	Pixel 9 Pro	6.2.0 / 6.0.3	darwin-x64	2025-01-19
iOS 18.2	iPhone 16 Pro Max	6.2.0 / 6.0.3	darwin-x64	2025-01-19
Android 34	Pixel 3a	6.0.0 / 6.0.0	darwin-arm	2024-06-02
iOS 17.5	iPhone 15 Pro Max	6.0.0 / 6.0.0	darwin-arm	2024-06-02
Android 35	Pixel 9	6.2.0 / 6.0.2	win11-x64	2024-12-21
Android 35	Pixel 9	6.2.0 / 6.0.2	linux-x64	2025-01-02

:::

:::danger Telemetry

Before starting this demo, manually disable telemetry. On Linux and MacOS:

npx @capacitor/cli telemetry off

To verify telemetry was disabled:

npx @capacitor/cli telemetry

:::

Integration Details

The SheetJS NodeJS Module can be imported from any component or script in the app.

This demo uses SvelteJS, but the same principles apply to other frameworks.

Reading data

The standard HTML5 File Input API works as expected in CapacitorJS.

Apps will typically include an input type="file" element. When the element is activated, CapacitorJS will show a file picker. After the user selects a file, the element will receive a change event.

The following example parses the selected file using the SheetJS read¹ method, generates an HTML table from the first sheet using sheet_to_html², and displays the table by setting the innerHTML attribute of a div element:

<script>
import { read, utils } from 'xlsx';

let html = "";

/* show file picker, read file, load table */
async function importFile(evt) {
  // highlight-start
  const f = evt.target.files[0];
  const wb = read(await f.arrayBuffer());
  // highlight-end
  const ws = wb.Sheets[wb.SheetNames[0]]; // get the first worksheet
  html = utils.sheet_to_html(ws); // generate HTML and update state
}
</script>

<main>
  <!-- highlight-next-line -->
  <input type="file" on:change={importFile}/>
  <div bind:this={tbl}>{@html html}</div>
</main>

Writing data

Starting from a SheetJS workbook object³, the write method with the option type: "base64"⁴ will generate Base64-encoded files.

The @capacitor/filesystem plugin can write Base64 strings to the device.

The following example uses the SheetJS table_to_book method⁵ to create a workbook object from an HTML table. The workbook object is exported to the XLSX format and written to the device.

<script>
import { Filesystem, Directory } from '@capacitor/filesystem';
import { utils, write } from 'xlsx';

let html = "";
let tbl;

/* get state data and export to XLSX */
async function exportFile() {
  /* generate workbook object from HTML table */
  const elt = tbl.getElementsByTagName("TABLE")[0];
  const wb = utils.table_to_book(elt);

  // highlight-start
  /* export to XLSX encoded in a Base64 string  */
  const data = write(wb, { bookType: "xlsx", type: "base64" });

  /* attempt to write to the device */
  await Filesystem.writeFile({
    data,
    path: "SheetJSCap.xlsx",
    directory: Directory.Documents
  });
  // highlight-end
}

</script>

<main>
  <button on:click={exportFile}>Export XLSX</button>
  <div bind:this={tbl}>{@html html}</div>
</main>

:::caution pass

Filesystem.writeFile cannot overwrite existing files. Production apps should attempt to delete the file before writing:

  /* attempt to delete file first */
  try {
    await Filesystem.deleteFile({
      path: "SheetJSCap.xlsx",
      directory: Directory.Documents
    });
  } catch(e) {}
  /* attempt to write to the device */
  await Filesystem.writeFile({
    data,
    path: "SheetJSCap.xlsx",
    directory: Directory.Documents
  });

:::

Demo

The app in this demo will display data in a table.

When the app is launched, a test file will be fetched and processed.

When a document is selected with the file picker, it will be processed and the table will refresh to show the contents.

"Export XLSX" will attempt to export the table data to SheetJSCap.xlsx in the app Documents folder. An alert will display the location of the file.

Base Project

0. Follow the official "Environment Setup"⁶ instructions to set up Android and iOS targets

:::caution pass

iOS development is only supported on macOS.

:::

Installation Notes (click to show)

For Android development, CapacitorJS requires a Java version compatible with the expected Gradle version. When this demo was tested against CapacitorJS 6.2.0, Java 20 was required to support Gradle 8.2.1.

1. Disable telemetry.

npx @capacitor/cli telemetry off

Verify that telemetry is disabled by running

npx @capacitor/cli telemetry

(it should print Telemetry is off)

2. Create a new Svelte project:

npm create vite@latest sheetjs-cap -- --template svelte
cd sheetjs-cap

3. Install dependencies:

{\ npm i --save https://cdn.sheetjs.com/xlsx-${current}/xlsx-${current}.tgz npm i --save @capacitor/core @capacitor/cli @capacitor/filesystem}

4. Create CapacitorJS structure:

npx cap init sheetjs-cap com.sheetjs.cap --web-dir=dist
npm run build

:::note pass

If prompted to create an Ionic account, type N and press Enter.

:::

5. Download src/App.svelte and replace:

curl -o src/App.svelte -L https://docs.sheetjs.com/cap/App.svelte

Android

6. Create Android app

npm i --save @capacitor/android
npx cap add android

:::caution pass

If the wrong Java version is installed, the last command will fail with a message that references a "class file major version"

> BUG! exception in phase 'semantic analysis' in source unit '_BuildScript_' Unsupported class file major version 67

The correct Java version must be installed. When this demo was last tested, Java 20 was compatible with CapacitorJS Android projects.

:::

7. Enable file reading and writing in the Android app.

Add the highlighted lines to android/app/src/main/AndroidManifest.xml after the Permissions comment:

    <!-- Permissions -->

<!-- highlight-start -->
    <uses-permission android:name="android.permission.READ_EXTERNAL_STORAGE"/>
    <uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE"/>
<!-- highlight-end -->

    <uses-permission android:name="android.permission.INTERNET" />

8. Start the Android simulator through Android Studio.

9. Run the app in the simulator:

npm run build
npx cap sync
npx cap run android

The app should look like the screenshot at the top of the page.

10. Test the export functionality.

Touch "Export XLSX". If the emulator asks for permission, tap "Allow". A popup will show the exported path.

Open the "Files" app in the simulator, tap the ≡ icon and tap "Documents". Tap the "Documents" folder to find SheetJSCap.xlsx.

Downloading the generated file (click to hide)

The file location can be found by searching for SheetJSCap.xlsx:

adb exec-out find / -name SheetJSCap.xlsx

There may be a number of error messages that start with find:. There will be at least one line starting with /:

/data/media/0/Documents/SheetJSCap.xlsx
/storage/emulated/0/Documents/SheetJSCap.xlsx

The /storage path can be pulled using adb pull:

adb pull "/storage/emulated/0/Documents/SheetJSCap.xlsx" SheetJSCap.xlsx

SheetJSCap.xlsx can be opened with a spreadsheet editor such as Excel.

11. Test the import functionality.

Edit SheetJSCap.xlsx, setting cell A7 to SheetJS Dev and setting cell B7 to 47. Save the file.

Click and drag the file into the Android emulator window. The file will be uploaded to a Downloads folder in the emulator.

Switch back to the app and tap "Choose File". In the selector, tap ≡, select "Downloads" and tap SheetJSCap.xlsx. The table will refresh with the new row.

iOS

12. Create iOS app.

npm i --save @capacitor/ios
npx cap add ios

13. Enable file sharing and make the documents folder visible in the iOS app. The following lines must be added to ios/App/App/Info.plist:

<plist version="1.0">
<dict>
<!-- highlight-start -->
  <key>UIFileSharingEnabled</key>
  <true/>
  <key>LSSupportsOpeningDocumentsInPlace</key>
  <true/>
<!-- highlight-end -->
  <key>CFBundleDevelopmentRegion</key>

(The root element of the document is plist and it contains one dict child)

14. Run the app in the simulator.

npm run build
npx cap sync
npx cap run ios

If prompted to select a target device, select "iPhone 16 Pro Max (simulator)".

The app should look like the screenshot at the top of the page.

15. Test the export functionality.

Touch "Export XLSX" and a popup will be displayed.

To see the generated file, switch to the "Files" app in the simulator and look for SheetJSCap.xlsx in "On My iPhone" > "sheetjs-cap"

Downloading the generated file (click to hide)

The app files are available in the filesystem in ~/Library/Developer. Open a terminal and run the following command to find the file:

find ~/Library/Developer -name SheetJSCap.xlsx

16. Test the import functionality.

Edit SheetJSCap.xlsx, setting cell A7 to SheetJS Dev and setting cell B7 to 47. Save the file.

Click and drag the file into the iOS simulator window. The simulator will show a picker for saving the file. Select the sheetjs-cap folder and tap "Save". If prompted to "Replace Existing Items?", tap "Replace".

Switch back to the app and tap "Choose File". Tap "Choose File" in the popup.

Tap on "Choose File" in the app and "Choose File" in the popup. In the picker, tap "Recents" and select the newest SheetJSCap file. The table will refresh.

Android Device

17. Connect an Android device using a USB cable.

If the device asks to allow USB debugging, tap "Allow".

18. Confirm the device is detected by adb.

adb devices

If the device is detected, the command will list the device:

List of devices attached
1234567890	device

19. Close any Android / iOS emulators.

20. Build APK and run on device:

npm run build
npx cap sync
npx cap run android

If the Android emulators are closed and an Android device is connected, the last command will build an APK and install on the device.

:::note pass

In some tests, the last command asked for a target device. Select the Android device in the list and press Enter

:::

:::caution pass

For real devices running API level 29 or below, the following line must be added to the application open tag in android/app/src/main/AndroidManifest.xml:

    <application
        android:allowBackup="true"
        android:icon="@mipmap/ic_launcher"
        android:label="@string/app_name"
        android:roundIcon="@mipmap/ic_launcher_round"
        android:supportsRtl="true"
        // highlight-next-line
        android:requestLegacyExternalStorage="true"
        android:theme="@style/AppTheme">

:::

iOS Device

21. Connect an iOS device using a USB cable

If prompted to "Trust This Computer", tap "Trust" and enter the device passcode.

22. Close any Android / iOS emulators.

23. Enable developer code signing certificates.

Open ios/App/App.xcworkspace in Xcode. Select the "Project Navigator" and select the "App" project. In the main view, select "Signing & Capabilities". Under "Signing", select a team in the dropdown menu.

24. Run on device:

npm run build
npx cap sync
npx cap run ios

When prompted to select a target device, select the real device in the list.

:::info pass

In some test runs, the build failed with a provisioning error:

error: Provisioning profile "iOS Team Provisioning Profile: com.sheetjs.cap" doesn't include the currently selected device "SheetJS Test Device" (identifier 12345678-9ABCDEF012345678). (in target 'App' from project 'App')

This error was resolved by manually selecting the device as the primary target in the Xcode workspace.

:::

:::caution pass

In some tests, the app failed to launch with a "Untrusted Developer" error.

Switch to the Settings app and select General > VPN & Device Management. There will be a new item in the "DEVELOPER APP" section. Tap the line and verify that sheetjs-cap is listed in the screen. Tap "Trust" and tap "Trust" in the popup.

After trusting the certificate, re-run the app:

npx cap run ios

:::

---

1. See read in "Reading Files" ↩︎

2. See sheet_to_html in "Utilities" ↩︎

3. See "Workbook Object" ↩︎

4. See the "base64" type in "Writing Files" ↩︎

5. See table_to_book in "HTML" Utilities ↩︎

6. See "Environment Setup" in the CapacitorJS documentation. ↩︎