react-native-asset


Link and unlink assets to your react-native project with ease!

Advantages

- react-native link only supports font files, this tool supports all assets.
- Unlinking is automatic when you delete an asset, with react-native link, you
need to unlink the files manually.
- Proper link (and unlink) for mp3 (to use with
react-native-sound)
and ttf files.

$3

Usage

- Install (globally or locally and later run with npx)
``bash
npm install -g react-native-asset
`
- Add assets to your react-native.config.js as you would with
react-native link
`js
...
assets: [
"./src/font",
"./src/mp3",
];
`
- Add platform-specific assets to your react-native.config.js like so:

`js
...
assets: [
"./src/mp3",
],
iosAssets: [
"./src/font/ios",
],
androidAssets: [
"./src/font/android",
],
`

- Run the command and linking + unlinking is automatic!
`bash
react-native-asset
`
Can also run with Deno without installing
`
deno run jsr:@unimonkiez/react-native-asset
`

Explanation

With react-native link you have to unlink the files manually, which is hard
work.\
Instead this library writes link-assets-manifest.json to the root of android
and ios folders to keep track of the files which it added, for later removing
it for you if missing from your assets!

Parameters

- -p, --path - path to project, defaults to cwd.
- -a, --assets - assets paths, for example
react-native-asset -a ./src/font ./src/mp3.
- -ios-a, --ios-assets - ios assets paths, will disable android linking
- -android-a, --android-assets - android assets paths, will disable ios
linking.
- -n-u, --no-unlink` - Not to unlink assets which not longer exists, not
recommended.

Backward compatability

- to use react-native 0.59 and below, use version 1.1.4