zylvex-tech/naija-ai-tutor

AI-powered tutoring platform for Nigerian curriculum (WAEC, NECO, JAMB) # Run and deploy your AI Studio app This contains everything you need to run your app locally. View your app in AI Studio: ai.studio ## Run Locally **Prerequisites:** Node.js 1. Install dependencies: `npm install` 2. Set the `GEMINI_API_KEY` in .env.local to your Gemini API key 3. Run the app: `npm run dev` ## Build for Production 1. Build the app: `npm run build` 2. Preview the production build locally: `npm run preview` ## Deploy to a free external host Two easy options: Vercel or Netlify. Both offer free static hosting and integrate with GitHub. Vercel (recommended for Vite): 1. Push your repository to GitHub. 2. Create an account at vercel.com and import the repo. 3. Vercel will auto-detect the Vite app. Use the default settings: - Build command: `npm run build` - Output directory: `dist` 4. Add any environment variables (e.g. `GEMINI_API_KEY`) in the project settings on Vercel. Netlify: 1. Push your repository to GitHub. 2. Create an account at app.netlify.com and click "New site from Git". 3. Connect your GitHub repo and set the build command to `npm run build` and publish directory `dist`. 4. Add any environment variables in Site settings > Build & deploy > Environment. Notes: - The production build was verified locally (`npm run build`) and succeeded. There is a chunk-size warning from Vite — consider lazy-loading large pages if needed. - I updated `package.json` devDependencies to use `@types/react` and `@types/react-dom` compatible with React 19 and removed `@types/react-router-dom` because `react-router-dom` v7 bundles its own types. --- ## Automated GitHub Actions deploys (Vercel / Netlify) You can enable automatic deployments from GitHub Actions after the CI build completes. The workflow will only run deploy jobs when the required repository secrets are present. Required repository secrets (GitHub): - Vercel (if you want automatic Vercel deploys): - `VERCEL_TOKEN` …