Guías de instalación
React Native / Expo
Integra Flowsery Analytics en tu aplicación React Native o Expo usando el entrypoint dedicado flowsery/react-native del paquete npm de Flowsery Analytics.
1. Instalar el SDK
Instala el paquete junto con sus dependencias peer requeridas:
Terminal
npm install flowsery @react-native-async-storage/async-storage @react-native-community/netinfo expo-constants expo-device2. Configurar variables de entorno
En tu proyecto Expo, define estas variables de entorno (por ejemplo en .env más tu configuración de Expo):
EXPO_PUBLIC_FLOWSERY_WEBSITE_ID-- tu ID de sitio web de Flowsery Analytics (ej.flid_******)EXPO_PUBLIC_FLOWSERY_DOMAIN-- debe coincidir con el dominio configurado en los ajustes de tu sitio web en Flowsery Analytics (para aplicaciones móviles puedes usar algo comoyourapp.com)
3. Envolver tu aplicación con FlowseryProvider
Envuelve tu árbol de navegación con el componente provider:
JavaScript
import { FlowseryProvider } from 'flowsery/react-native';
export default function RootLayout() {
return (
<FlowseryProvider
config={{
websiteId: process.env.EXPO_PUBLIC_FLOWSERY_WEBSITE_ID!,
// Must match the domain configured in your Flowsery Analytics website settings
domain: process.env.EXPO_PUBLIC_FLOWSERY_DOMAIN!,
debug: __DEV__,
}}>
{/* your navigation / screens here */}
</FlowseryProvider>
);
}JavaScript
import { useFlowseryScreen } from 'flowsery/react-native';
export default function HomeScreen() {
useFlowseryScreen('HomeScreen');
return <YourScreenUI />;
}JavaScript
import { Pressable, Text } from 'react-native';
import { useFlowseryTrack } from 'flowsery/react-native';
export function CTAButton() {
const track = useFlowseryTrack();
return (
<Pressable onPress={() => track('cta_click', { source: 'home_screen' })}>
<Text>Tap to send a test event</Text>
</Pressable>
);
}JavaScript
import { useFlowsery } from 'flowsery/react-native';
export async function onLoginSuccess(user) {
const client = useFlowsery();
await client?.identify(user.id, {
email: user.email,
name: user.name,
});
}5. ¿Por qué los paquetes adicionales?
El entrypoint flowsery/react-native depende de:
- AsyncStorage para almacenamiento persistente
- NetInfo para detectar el estado de la red
- Expo Constants / Device (cuando está disponible) para metadata de la aplicación y del dispositivo
Por eso esos paquetes adicionales de React Native / Expo deben instalarse junto con flowsery.