(Confirmed the current repo README is the default Lovable boilerplate and the listed stack is Vite + TS + React + shadcn-ui + Tailwind.) :contentReference[oaicite:0]{index=0}
# English Learn
A simple **English-learning companion** web app built with Vite + React (TypeScript) and a clean shadcn-ui + Tailwind UI.
* * *
## What problem this solves
Learning English consistently is hard when:
- practice is not structured,
- materials are scattered,
- progress is hard to track.
This repo aims to provide a single place to practice and stay consistent.
* * *
## Main features (in this repo)
- A fast, responsive UI for English-learning workflows (content + practice)
- Easy to extend inside `src/`
- Optional backend/data layer (there is a `supabase/` folder in this repo — configure only if you need it)
> Note: Exact screens/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 any external services, create an env file (don’t commit secrets):
cp .env .env.local
Then edit .env.local.
3) Start dev server
npm run dev
Environment variables
Because this repo includes a .env file, make sure you do not commit real secrets.
Recommended approach:
keep .env.local for your machine (gitignored)
add .env.example with empty placeholders
Typical Vite + Supabase keys look like:
VITE_SUPABASE_URL
VITE_SUPABASE_ANON_KEY
If your project uses different names, search the codebase for VITE_ or SUPABASE.
Database (optional)
If you’re using Supabase:
project config / migrations typically live under supabase/
run migrations using the Supabase CLI (if included in your workflow)
Contributing
PRs and improvements are welcome:
add content
improve UI/UX
fix bugs
License
No license file is included yet.
Add LICENSE if you want clear reuse permissions (MIT is common).