@hackler/react-sdk/README.md

React SDK for Hackle

# Hackle React SDK

## Install
```shell script
npm install @hackler/react-sdk --save
yarn add @hackler/react-sdk
```

## Usage

### initialize
```javascript
import { createInstance, HackleProvider } from "@hackler/react-sdk";

const hackleClient = createInstance("YOUR_SDK_KEY")
const user = {
  id: "ae2182e0", 
  properties: {
    app_version: "1.0.1",
    age: 23,
    paying_customer: true
  } 
}
ReactDOM.render(
  <HackleProvider hackleClient={hackleClient} user={user} timeout={1000}>
    <YourApp />
  </HackleProvider>,
  document.getElementById('root')
);
```

### Decide the variation
```javascript
function App() {
  return (
    <HackleExperiment experimentKey={42}>
      <HackleVariation variation={"A"}>
        <OldBlueButton />
      </HackleVariation>
      <HackleVariation variation={"B"}>
        <NewRedButton />
      </HackleVariation>
    </HackleExperiment>
  )
}
```

### Records the event
```javascript
const track = useTrack()
const event = {
  key: "purchase",
  value: 5000,
  properties: {
    first_paying: false,
    item_count: 5
  }
}

<button onClick={() => track(event)}>Purchase</button>
```