README.md

🌱 NMF.earth app

Calculate, understand and reduce your carbon footprint

Repository for the NMF.earth React Native application, built with Expo, Redux Toolkit and Typescript.

📦 Getting started

Installing Dependencies:

$ yarn

Running the app:

$ yarn start

For starting the app on a specfic OS:

$ yarn ios | yarn android

Copy the 2 files that contains secrets and replace them with yours

$ cp app.example.json app.json
$ cp secret.example.ts secret.ts

👩🏾‍💻 Development

• Eslint is used in the project to enforce code style and should be configured in your editor.

• Typescript is used in the project for typechecking and should be configured in your editor.

You can also check this manually by running:

yarn lint

or

yarn typescript

🛠 Testing

Use the following command to run unit tests with coverage:

$ yarn test

Use the following to update unit tests

$ yarn test -u

Use the following to run unit tests in watch mode while developing:

$ yarn test --watch

📚Storybook

Stories (*.story.tsx) can be automatically added to storyLoader.js with :

$ yarn prestorybook

🚀 Deployment

Any branches merged into master will trigger a github action that runs expo publish. During this step app.example.json is used to generate an app.json file for expo's deployment, this is done with the following script scripts/generate-app-json.js.

👨‍💻 Contributors

Have a look here if you want to contribute!

🌐 You can help us with translations with our online tool POEditor.

🏆 Backers

A big thank you to Christopher Gwilliams and to the Phelps family for their amazing contribution to the Kickstarter!

©️ Open source - licence

Repository and contributions are under GNU General Public License v3.0