tess-framework/README.md

Lightweight TypeScript/Rust full-stack framework with Vue 3 + Vite

# Tess Framework

A lightweight TypeScript/Rust full-stack framework with Vue 3, Vite, and Tailwind CSS.

## Quick Start

```bash
npm install -g tess-framework
tess init my-app
cd my-app
tess dev
```

## Features

- **Frontend**: Vue 3 + TypeScript + Tailwind CSS + Vite
- **Backend**: TypeScript or Rust APIs (or both)
- **Development**: Hot reload, instant API setup
- **Production**: Optimized builds, deployment ready

## Commands

- `tess init <project-name>` - Create new project
- `tess dev` - Start development server
- `tess build` - Build for production
- `tess run <script>` - Run npm scripts
- `tess publish` - Deploy to Vercel/Netlify

## Project Structure

```
my-app/
├── app/
│   ├── pages/          # Vue pages (auto-routed)
│   ├── comp/           # Vue components
│   ├── api/            # API endpoints
│   ├── assets/         # Static assets
│   └── App.vue
├── .v/
│   ├── system/         # Build system
│   └── build/          # Production build
└── src/                # Rust source (if enabled)
```

## API Routes

TypeScript APIs go in `app/api/`:

```typescript
// app/api/hello.ts
export async function GET(req: any, res: any) {
  res.end(JSON.stringify({ message: 'Hello from Tess!' }))
}
```

Access at: `http://localhost:8000/api/hello`

## Configuration

Configure routes and links in `app/assets/data/.tess.yml`:

```yaml
pages:
  home: landing
  
links:
  gh: github.com/yourusername/repo
```

## Requirements

- Node.js 16+
- Rust (optional, for Rust APIs)

## License

MIT