A Vite + Preact app for tracking orthodontic braces activity (remove/replace events) per user.
- Firebase email/password login
- Per-user braces setup (
users/{uid}/braces) - Event tracking per brace (
removeandreplace) - Edit and delete previously logged events
- Current brace status based on latest event
- Dedicated pages for tracking, all events, setup, and stats
- Responsive Material UI interface with automatic light/dark theme selection
- Preact + Vite
- Material UI (
@mui/material,@mui/x-date-pickers) - Day.js
- Firebase Auth + Firestore
- Firebase Hosting (configured)
- Node.js 18+
- npm
- A Firebase project with:
- Email/Password authentication enabled
- Firestore database enabled
- Install dependencies:
npm install- Create a
.env.localfile in the project root:
VITE_FIREBASE_API_KEY=your_api_key
VITE_FIREBASE_AUTH_DOMAIN=your_project.firebaseapp.com
VITE_FIREBASE_PROJECT_ID=your_project_id
VITE_FIREBASE_MESSAGING_SENDER_ID=your_sender_id
VITE_FIREBASE_APP_ID=your_app_id
VITE_FIREBASE_MEASUREMENT_ID=your_measurement_id- Start the dev server:
npm run dev- Open the URL shown in the terminal (typically
http://localhost:5173).
npm run dev: Start local development servernpm run build: Create production build indist/npm run preview: Preview the production build locally
users/{userId}users/{userId}/braces/{braceId}numbercreatedAt
users/{userId}/braces/{braceId}/events/{eventId}eventType(removeorreplace)eventTimecreatedAt- optional
updatedAt
This repository includes:
firestore.rulesfirestore.indexes.jsonfirebase.json
Deploy rules/indexes and hosting with Firebase CLI:
firebase deploy --only firestore:rules,firestore:indexes
npm run build
firebase deploy --only hosting.firebaserc currently points to Firebase project skinnetracker.
src/
components/
pages/
service/
lib/
public/
- The app requires authentication before any tracker routes are available.
- Create braces from the Setup page before tracking events.