<summary>Setup for Create React App or Vite</summary>
Add `AptabaseProvider` to your root component:
```tsx
import { AptabaseProvider } from '@aptabase/react';
ReactDOM.createRoot(root).render(
<React.StrictMode>
<AptabaseProviderappKey="<YOUR_APP_KEY>">
<YourApp/>
</AptabaseProvider>
</React.StrictMode>,
);
```
</details>
## Advanced setup
The `AptabaseProvider` also supports an optional second parameter, which is an object with the `appVersion` property.
It's up to you to decide what to get the version of your app, but it's generally recommended to use your bundler (like Webpack, Vite, Rollup, etc.) to inject the values at build time.
## Tracking Events with Aptabase
After setting up the `AptabaseProvider`, you can then start tracking events using the `useAptabase` hook.
Here's an example of a simple counter component that tracks the `increment` and `decrement` events:
```js
'use client';
import { useState } from 'react';
import { useAptabase } from '@aptabase/react';
export function Counter() {
const { trackEvent } = useAptabase();
const [count, setCount] = useState(0);
function increment() {
setCount((c) => c + 1);
trackEvent('increment', { count });
}
function decrement() {
setCount((c) => c - 1);
trackEvent('decrement', { count });
}
return (
<div>
<p>Count: {count}</p>
<buttononClick={increment}>Increment</button>
<buttononClick={decrement}>Decrement</button>
</div>
);
}
```
A few important notes:
1. The SDK will automatically enhance the event with some useful information, like the OS, the app version, and other things.
2. You're in control of what gets sent to Aptabase. This SDK does not automatically track any events, you need to call `trackEvent` manually.
- Because of this, it's generally recommended to at least track an event at startup
3. You do not need to await the `trackEvent` function, it'll run in the background.
