# Supported platforms

## NodeJS[​](#nodejs "Direct link to NodeJS")

TypeORM is compatible with Node.js 20+ and currently each commit is tested on Node.js 20 and 24.

## Browser[​](#browser "Direct link to Browser")

You can use [sql.js](https://sql.js.org) in the browser.

### Webpack configuration[​](#webpack-configuration "Direct link to Webpack configuration")

In the `browser` folder the package also includes a version compiled as a ES2015 module. If you want to use a different loader this is the point to start. Prior to TypeORM 0.1.7, the package is setup in a way that loaders like webpack will automatically use the `browser` folder. With 0.1.7 this was dropped to support Webpack usage in Node.js projects. This means, that the `NormalModuleReplacementPlugin` has to be used to insure that the correct version is loaded for browser projects. The configuration in your webpack config file, for this plugin looks like this:

```
plugins: [

    ..., // any existing plugins that you already have

    new webpack.NormalModuleReplacementPlugin(/typeorm$/, function (result) {

        result.request = result.request.replace(/typeorm/, "typeorm/browser");

    }),

    new webpack.ProvidePlugin({

      'window.SQL': 'sql.js/dist/sql-wasm.js'

    })

]
```

and make sure [sql-wasm.wasm file](https://github.com/sql-js/sql.js/blob/master/README.md#downloadingusing) exists in your public path.

### Example of configuration[​](#example-of-configuration "Direct link to Example of configuration")

```
new DataSource({

    type: "sqljs",

    entities: [Photo],

    synchronize: true,

})
```

### Don't forget to include reflect-metadata[​](#dont-forget-to-include-reflect-metadata "Direct link to Don't forget to include reflect-metadata")

In your main html page, you need to include reflect-metadata:

```
<script src="./node_modules/reflect-metadata/Reflect.js"></script>
```

## Capacitor[​](#capacitor "Direct link to Capacitor")

See [Using TypeORM with the Capacitor driver type](https://github.com/capacitor-community/sqlite/blob/master/docs/TypeORM-Usage-From-5.6.0.md) in the official Capacitor docs.

## Cordova / Ionic apps[​](#cordova--ionic-apps "Direct link to Cordova / Ionic apps")

TypeORM is able to run on Cordova/Ionic apps using the [cordova-sqlite-storage](https://github.com/litehelpers/Cordova-sqlite-storage) plugin. You have the option to choose between module loaders just like in browser package. **Important**: For use with Ionic, a custom webpack config file is needed. Note that there is currently no support for transactions when using the [cordova-sqlite-storage](https://github.com/litehelpers/Cordova-sqlite-storage) plugin. See [Cordova SQLite limitations](https://github.com/storesafe/cordova-sqlite-storage#other-limitations) for more information.

## Expo[​](#expo "Direct link to Expo")

TypeORM is able to run on Expo apps using the [Expo SQLite API](https://docs.expo.io/versions/latest/sdk/sqlite/).

## NativeScript[​](#nativescript "Direct link to NativeScript")

1. `tns install webpack` (read below why webpack is required)

2. `tns plugin add nativescript-sqlite`

3. Create a DataSource in your app's entry point

   ```
   import driver from "nativescript-sqlite"



   const dataSource = new DataSource({

       database: "test.db",

       type: "nativescript",

       driver,

       entities: [

           Todo, //... whatever entities you have

       ],

       logging: true,

   })
   ```

Note: This works only with NativeScript 4.x and above

*When using with NativeScript, **using webpack is compulsory**. The `typeorm/browser` package is raw ES7 code with `import/export` which will **NOT** run as it is. It has to be bundled. Please use the `tns run --bundle` method*

Checkout example [here](https://github.com/championswimmer/nativescript-vue-typeorm-sample)!

## React Native[​](#react-native "Direct link to React Native")

TypeORM is able to run on React Native apps using the [react-native-sqlite-storage](https://github.com/andpor/react-native-sqlite-storage) plugin.