How to contribute?

Hi Team,

Can someone explain how to develop using a fork of this repo in order to create PRs and facilitate debugging? Of course, there is the CONTRIBUTING guide which gives some guidance for best practices, but how do you get to a valid development environment on this project?

Let’s say I am on Windows, I have a React basic app, and this cloned repo…

my-app make use of @aws-amplify/auth and @aws-amplify/cache.

Using yarn link, how do I get my-app to use the locally modified version of @aws-amplify/auth?

Probably something like

yarn
yarn run bootstrap
yarn run build
yarn run link

… and in my-app: yarn run link "@amplify-js/auth"

But then I get a message Module not found: Can't resolve '@aws-amplify/core' in 'C:\repos\amplify-js\packages\auth\lib'

[elorzafe]

Hi @sebastienfi

After doing yarn build on the root directory of aws-amplify, I go to ./packages/aws-amplify and do yarn link.

In order to test my changes on an app. First I install aws-amplify package and then do yarn link aws-amplify.

Pro-tip: When I use VS Code I use tsc: watch - package/auth/tsconfig.json (cmd+shift+b) so every time I make a change on any src file inside of that package it compiles immediately, so you don’t need to build manually again.

I hope that helps

[elorzafe]

@sebastienfi we are going to update our wiki/README with this information.