Prathap-Alpha/lumen-ai
Creator:
Pra
Host:
Lumen - Botswana-born AI consultancy. Marketing site (Vite + React + TypeScript). lumen-ai.pro
# Web App Template (Static Frontend)
Pure React 19 + Tailwind 4 template with shadcn/ui baked in. **Use this README as the checklist for shipping static experiences.**
> **Note:** This template includes a minimal `shared/` and `server/` directory with placeholder types to support imported templates. These are just compatibility placeholders - web-static remains a true static-only template without API functionality.
---
## Stack Overview
- Client-only routing powered by React + Wouter.
- Design tokens live entirely in `client/src/index.css`—keep that file intact.
## File Structure
```
client/
public/ ← Small configuration files ONLY (favicon.ico, robots.txt). DO NOT put images/media here.
src/
pages/ ← Page-level components
components/ ← Reusable UI & shadcn/ui
contexts/ ← React contexts
hooks/ ← Custom React hooks
lib/ ← Utility helpers
App.tsx ← Routes & top-level layout
main.tsx ← React entry point
index.css ← global style
server/ ← Placeholder for imported template compatibility
shared/ ← Placeholder for imported template compatibility
const.ts ← Shared constants
```
### ⚠️ Handling Images & Media
**DO NOT** store images, videos, or large assets in `client/public/` or `client/src/assets/`. Local media files will cause deployment timeouts.
**Required workflow:**
1. Upload assets using the CLI: `manus-upload-file --webdev path/to/image.png`
2. Use the returned storage path directly in your code: ` `
3. Store the original local file in `/home/ubuntu/webdev-static-assets/` (outside the project directory)
Only small configuration files like `favicon.ico`, `robots.txt`, and `manifest.json` belong in `client/public/`.
Files in `client/public` are available at the root of your site—reference them with absolute paths (`/robots.txt`, etc.) from HTML templates, JSX, or meta tags.
---
## 🎯 Development Workflow
1. **Choose a design style** before you write any frontend code according to Design Guide (color, …