# kasy

CLI for scaffolding production-ready Flutter SaaS apps.

## Install

**macOS & Linux**

```bash
curl -fsSL https://kasy.dev/install | bash
```

**Windows (PowerShell)**

```powershell
irm https://kasy.dev/install.ps1 | iex
```

Or via npm:

```bash
npm install -g kasy-cli
```

## Quick start

```bash
kasy new my-app
```

The wizard will ask for your app name, bundle ID, and backend. A complete Flutter project is generated and ready to run.

## Commands

| Command | Description |
|---|---|
| `kasy new [dir]` | Create a new Flutter SaaS project |
| `kasy add <module>` | Add a feature to an existing project |
| `kasy remove <module>` | Remove a feature |
| `kasy doctor` | Check your environment (Flutter, Node, CLIs) |
| `kasy features` | List available backends and modules |
| `kasy deploy [dir]` | Deploy backend (Firebase Functions / Supabase) |
| `kasy ios release [dir]` | Build and release to the App Store |
| `kasy run [dir]` | Run the app on a device or simulator |

## Backends

- **Firebase** — Firestore, Cloud Functions, Google Sign-In
- **Supabase** — PostgreSQL, Edge Functions, RLS policies
- **API REST** — Express/Node.js server included

## Optional modules

`sentry` · `analytics` · `revenuecat` · `onboarding` · `widget` · `ai_chat` · `facebook` · `local_notifications` · `feedback` · `ci`

## Requirements

- Node.js >= 18
- Flutter SDK (any recent stable version)
- Firebase CLI or Supabase CLI (depending on backend)

## Languages

The CLI wizard runs in **English**, **Portuguese**, or **Spanish** — detected automatically from your system locale.