SPARK ⚡

Showcase Platform for AI Research & Knowledge

Internal AI tools showcase for the company. Discover, vote on, and share the AI tools being built across the organisation.

---

Stack

• Vite + React — frontend
• Firebase Auth — Google SSO restricted to @safetyculture.io
• Firestore — database (europe-west2)
• Vercel — hosting (auto-deploy from GitHub main)

---

Setup

1. Create a Firebase project

1. Go to console.firebase.google.com
2. Create a new project — name it spark-app (or similar)
3. Enable Authentication → Google sign-in method, set a support email
4. Create a Firestore database — choose europe-west2 region, start in production mode
5. Add authorised domains: localhost and your Vercel URL (add this after first deploy)

2. Configure Firebase in the app

Copy your project config from Firebase console → Project settings → Your apps → Web:

// src/lib/firebase.js
const firebaseConfig = {
  apiKey: "your-api-key",
  authDomain: "your-project.firebaseapp.com",
  projectId: "your-project-id",
  storageBucket: "your-project.firebasestorage.app",
  messagingSenderId: "your-sender-id",
  appId: "your-app-id"
}

3. Deploy Firestore security rules

npm install -g firebase-tools
firebase login
firebase use your-project-id
firebase deploy --only firestore:rules,firestore:indexes

4. Deploy to Vercel

1. Push this repo to GitHub (benhewsonedwards/spark)
2. Go to vercel.com → New Project → Import from GitHub
3. Framework: Vite (auto-detected)
4. Deploy — no environment variables needed
5. Copy the Vercel URL and add it to Firebase Auth → Authorised domains

5. First login

Sign in with your @safetyculture.io Google account. Your user document is created automatically in Firestore.

---

Development

npm install
npm run dev

---

Firestore Data Model

Collection	Purpose
users/{uid}	User profiles
tools/{toolId}	Submitted tools
tools/{toolId}/comments/{commentId}	Tool comments

---

Tag Dimensions

Each tool is tagged across three dimensions:

• Function — what the tool does (Automation, Data & Analytics, etc.)
• Audience — who uses it (Customer-Facing, Internal / CSE, GTM, etc.)
• Domain — what area it covers (Sales, Onboarding, Sustainability, etc.)

Users can filter by any combination across all three dimensions.