Documentation

git clone https://github.com/bananalytics-analytics/bananalytics.git
cd bananalytics/server
docker-compose up -d

docker exec -i server-postgres-1 psql -U bananalytics -d bananalytics \
  < internal/storage/postgres/migrations/001_create_projects.up.sql
docker exec -i server-postgres-1 psql -U bananalytics -d bananalytics \
  < internal/storage/postgres/migrations/002_create_events.up.sql
docker exec -i server-postgres-1 psql -U bananalytics -d bananalytics \
  < internal/storage/postgres/migrations/003_add_key_hashes.up.sql
docker exec -i server-postgres-1 psql -U bananalytics -d bananalytics \
  < internal/storage/postgres/migrations/004_add_geo.up.sql

curl -X POST http://localhost:8080/v1/projects \
  -H "Content-Type: application/json" \
  -d '{"name":"My App"}'

# Returns: { "write_key": "rk_...", "secret_key": "sk_..." }

npm install @bananalytics/react-native
npm install @react-native-async-storage/async-storage

import { Bananalytics } from '@bananalytics/react-native';

Bananalytics.init({
  apiKey: 'rk_your_write_key',
  endpoint: 'https://your-server.com',
  debug: true,
});

// Track custom events
Bananalytics.track('button_clicked', { button: 'signup' });

// Track screen views
Bananalytics.screen('HomeScreen');

// Identify users
Bananalytics.identify('user-123', { plan: 'pro' });

// Flush events immediately
await Bananalytics.flush();

import { BananalyticsProvider, useBananalytics, useTrackScreen } from '@bananalytics/react-native';

function App() {
  return (
    <BananalyticsProvider config={{ apiKey: 'rk_...', endpoint: '...' }}>
      <HomeScreen />
    </BananalyticsProvider>
  );
}

function HomeScreen() {
  useTrackScreen('HomeScreen');
  const bananalytics = useBananalytics();

  return (
    <Button onPress={() => bananalytics.track('tapped')} title="Tap" />
  );
}

// After user logs in
Bananalytics.identify('user-123', { plan: 'free' });

// Screen views (auto-tracked with useTrackScreen hook)
Bananalytics.screen('HomeScreen');
Bananalytics.screen('ProductScreen');

// Core conversion funnel
Bananalytics.track('product_viewed', {
  product_id: 'prod_abc', price: 49.99, category: 'shoes'
});
Bananalytics.track('add_to_cart', {
  product_id: 'prod_abc', quantity: 1, price: 49.99
});
Bananalytics.track('checkout_started', {
  cart_value: 49.99, item_count: 1
});
Bananalytics.track('purchase_completed', {
  order_id: 'ord_xyz', total: 49.99, currency: 'USD'
});

// Engagement signals
Bananalytics.track('search_performed', {
  query: 'running shoes', results_count: 24
});
Bananalytics.track('share_tapped', {
  content_type: 'product', share_method: 'instagram'
});

// Error tracking
Bananalytics.track('payment_failed', {
  error_type: 'card_declined', retry_count: 0
});

curl -H "Authorization: Bearer sk_your_secret_key" http://localhost:8080/v1/query/events

# SSH into your server
ssh root@your-server-ip

# Install Docker
curl -fsSL https://get.docker.com | sh

# Clone and start
git clone https://github.com/bananalytics-analytics/bananalytics.git
cd bananalytics/server

# Set your domain (Caddy auto-provisions SSL)
echo "ROCHADE_DOMAIN=analytics.yourdomain.com" > .env
echo "ROCHADE_CORS_ORIGINS=https://yourdomain.com" >> .env

# Start everything (Postgres + Go server + Caddy HTTPS)
docker-compose up -d