metro-with-symlinks

KO | EN

gitlite — search

#javascript #hacktoberfest #typescript #machine-learning #deep-learning #macos #nodejs #java #windows #kubernetes #pytorch #security #ios #mcp

metro-with-symlinks

(★ 53)

Metro with Symlinks

파일 탐색기

최종 버전 다운로드 (.zip)

- androidstudio_screenshot.png
- xcode_screenshot.png
- index.js
- cli.js
- getDependencyPath.js
- getMetroConfig.js
- getSymlinkedDependencies.js
.gitignore
package.json
prettier.config.js
README.md
yarn.lock

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# metro-with-symlinks

There is a longstanding [issue](https://github.com/facebook/metro/issues/1#issuecomment-386852670) with [Metro](https://github.com/facebook/metro) not accepting symlinks and thus making it hard to use in monorepo setups or example projects. This script provides a solution.

This package generates a custom `rn-cli.config.js` file based on checking for symlinks inside the `node_modules`. It also takes care of making peer dependencies available to those symlinked modules.

## Usage

```bash
# Install
yarn add -D metro-with-symlinks
# or
npm install -D metro-with-symlinks
```

In the most recent version of the metro bundler, you just need to have a `rn-cli.config` file in your root folder and it will automatically be read by the bundler. You can generate that file by running `metro-with-symlinks` without any argument in the terminal, which will generate the `rn-cli.config` file. You will have to regenerate this file, whenever you symlink another package or add a peerDependency to your link

### Side Effects

Since this fix consists of adding linked packages as react-native project roots, this causes react native to try and transpile the code of the package. This can be an issue if your package has its own transpilation process, leading to multiple transpilation attempts on the same code. To prevent this from happening, you'll have to ignore the linked package from inside the react native projects `.babelrc`. For example:

```json
{
  ... 
  "ignore": [
    "some-linked-package"
  ]
}
```

## Usage (Older Versions)

In older versions, you have to tell the packager where to find the config file. To do so you can simply replace the standard `react-native` commands with this custom command. For example: replace the start script in your `package.json` with this:

```json
"scripts": {
    "start": "metro-with-symlinks start",
}
```

## Using with Xcode (Only Older Versions)

```bash
# You will need to have run this or the start command above to generate rn-cli.config.js config.
yarn metro-with-symlinks
```

In Xcode you can assign an environment variable in the build phase `Bundle React Native code and images`.
Add:

```bash
export BUNDLE_CONFIG=./rn-cli.config.js
```

![Xcode bundle config](https://raw.githubusercontent.com/MrLoh/metro-with-symlinks/master/assets/xcode_screenshot.png)

## Using with Gradle (Only Older Versions)

In Android you just have to include `bundleConfig: "./rn-cli.config.js"` in the `project.ext.react` field of your `android/app/build.gradle`:

![Android Studio bundle config](https://github.com/MrLoh/metro-with-symlinks/raw/master/assets/androidstudio_screenshot.png)

## Contributing

If there is a specific feature you are missing, please create an issue or ideally open a pull request.

metro-with-symlinks

파일 탐색기

오늘의 추천 프로젝트

Was this content helpful?

Recent Feedback

metro-with-symlinks

파일 탐색기

오늘의 추천 프로젝트

Was this content helpful?

Recent Feedback

Download README