setup.md

Installation - setup

Install global tools

Install nix package manager

If you have a pass Culture's computer, which has a proxy that adds a custom certificate, the install may fail.

In that case, you will need to install Nix as follows :

curl --proto '=https' --tlsv1.2 -sSf -L https://install.determinate.systems/nix | sh -s -- install --determinate --ssl-cert-file '/Library/Application Support'/*/*/data/*cacert.pem

If you want more information or if you have a problem you can consult nix package manager installation.

Install DirEnv

1. Install the executable

   brew install direnv

   If you want more information or if you have a problem you can consult DirEnv installation.

2. You will need to add hook into your user configuration (example: ~/.zshrc).

3. Start a new terminal to load the new configuration.

Load project environment

cd ./pass-culture-app-native # if needed
direnv allow

The last step can take several tens of minutes, especially the first time.

Troubleshooting

🚨 If you got this error when executing direnv allow 🚨

/nix/store/559pz0w6zlvw8yyxah9s10fhaz400vaj-stdenv-darwin/setup: line 138: pop_var_context: head of shell_variables not a function context

Try to upgrade bash

brew install bash

If still doesn't work, run it twice

direnv allow

Something is wrong

Try to reload environment

direnv reload

Still wrong ?

direnv deny
direnv allow

Still wrong ?

direnv deny
git clean -dxf .direnv .devbox .venv
npx rn-game-over --all
direnv allow

Still wrong ?

Save the content of the terminal to be able to understand what did wrong

Ask for help

IOS and Android setup

We advise to follow the guidelines to set up your environment by selecting your Development OS and your target OS (Android/iOS).

Android

Follow the steps here.

iOS

Follow the steps here.

Test setup

To make sure your environment is set up correctly, try to run a template application with Create React Native App or with react-native-cli.