(Confirmed the current repo README is the default Lovable boilerplate and the listed stack is Vite + TS + React + shadcn-ui + Tailwind.) :contentReference[oaicite:1]{index=1}
# Phys Lab Buddy
A **physics lab helper** web app built with Vite + React (TypeScript) and a clean shadcn-ui + Tailwind UI.
* * *
## What problem this solves
Lab work gets messy fast:
- formulas, steps, and notes are spread out,
- calculations are repeated,
- report prep takes longer than it should.
This repo aims to provide a simple UI to help you organize and move faster.
* * *
## Main features (in this repo)
- Fast, responsive UI (Vite + React)
- Easy to expand with lab modules/components inside `src/`
- Optional backend/data layer (there is a `supabase/` folder in this repo — configure only if needed)
> Note: Exact modules/features depend on what’s implemented in `src/`.
* * *
## Tech stack
- Vite
- TypeScript
- React
- shadcn-ui
- Tailwind CSS
- (Optional) Supabase (if configured)
* * *
## Run locally
### 1) Install
```bash
npm install
2) Configure environment (optional)
If the app uses Supabase or other services:
cp .env .env.local
Edit .env.local with your credentials (don’t commit secrets).
3) Start dev server
npm run dev
Environment variables
Recommended:
keep secrets in .env.local (gitignored)
add .env.example with placeholders
Typical Vite + Supabase keys:
VITE_SUPABASE_URL
VITE_SUPABASE_ANON_KEY
If your project uses different names, search for VITE_ / SUPABASE in the code.
Database (optional)
If you’re using Supabase:
look inside supabase/ for schema/migrations/config
use the Supabase CLI if that’s part of your workflow
Contributing
Ideas that are welcome:
better UX for lab workflows
new experiment templates/modules
bug fixes and cleanup
License
No license file is included yet.
Add LICENSE (MIT is common) if you want clear reuse permissions.
(Confirmed the current repo README is the default Lovable boilerplate and the listed stack is Vite + TS + React + shadcn-ui + Tailwind.) :contentReference[oaicite:2]{index=2}
DONE
::contentReference[oaicite:3]{index=3}