A component that encapsulates Trello's API token-based authentication to grant third-party applications access to the Trello API.
This library is available on npm, install it with: npm install --save react-native-trello-login or yarn add react-native-trello-login.
react-native-trello-loginimport TrelloLogin from "react-native-trello-login";
To begin the authentication process, you need an API key. Every Trello user is given an API key.
You can retrieve your API key by logging into Trello and visiting https://trello.com/app-key/.
Because the API key is tied to the user, it is often a good idea to create a Trello user specifically for building a single application or integration. This ensures that a third-party's integration is disassociated from a third-party integration's developer's Trello account.
It's also suggested to define the API key in a separate file or in an environment variable.
const TRELLO_API_KEY = "YOUR_API_KEY_HERE";
The imported TrelloLogin component is just a React-Native WebView that will take care of showing and handling the Trello auth process.
export default class TrelloLoginExample extends React.Component {
handleLoginSuccess = trelloAuthToken => {// The user authenticated successfully.// From now on you'll be able to use the Trello APIs using `trelloAuthToken`
};
handleLoginFailure = message => {// Handle the authentication failure (maybe by showing an alert?)
};
render() {return ( <View style={styles.container}><TrelloLogin applicationName="React Native Trello Login Example" onLoginSuccess={this.handleLoginSuccess} onLoginFailure={this.handleLoginFailure} trelloApiKey={TRELLO_API_KEY} style={styles.webview}/> </View>);
}}See the /example folder for a complete example (login + logout).
| Name | Type | Default | Description |
|---|---|---|---|
| applicationName | string | REQUIRED | The application name shown to the user in the login process |
| debugEnabled | bool | false | When true, shows a few useful console.debug logs during the login process |
| onLoginFailure | func | REQUIRED | Callback invoked on a failed login (callback parameter: error message) |
| onLoginSuccess | func | REQUIRED | Callback invoked on a successful login (callback parameter: auth token) |
| trelloApiKey | string | REQUIRED | The Trello API key |
| style | any | null | Style applied to the Trello login WebView |
Please notice that you can also provide any WebView prop.
Trello auth docs
Trello API docs
Your Trello API key
React-Native WebView docs