<div align="center">
  <img src="https://placehold.co/200x200?text=AS%20Facile" alt="AS Facile logo" width="200" height="200" />

  <h1>AS Facile.js</h1>
  <p>Lightweight, minimal API framework with a friendly CLI.</p>
</div>

## Features
- ⚡ Lightweight HTTP framework with middleware and routing.
- 🧩 Simple router with path params and middleware chaining.
- 🧰 Built-in CLI to scaffold a new project or generate modules.

## Installation
```bash
npm install as-facile-js
```

## Quick start
```ts
import { createApp, Router, json } from "as-facile-js";

const app = createApp();
app.use(json());

const router = Router();
router.get("/health", (req, res) => {
  res.json({ ok: true });
});

app.use(router);

app.listen(3000, () => {
  console.log("Server running on http://localhost:3000");
});
```

## CLI usage
### Initialize a new project
```bash
npx as-facile-js init my-api
# or shorthand
npx as-facile-js my-api
```

### Generate a module
```bash
cd my-api
npx as-facile-js -g users
```

### CLI help / version
```bash
npx as-facile-js --help
npx as-facile-js --version
```

## Project structure (generated)
```
my-api/
  src/
    server.ts
    modules/
      # generated by default
      health/
        health.controller.ts
        health.payload.ts
        health.route.ts
        health.service.ts
```

## Scripts (generated project)
```bash
npm run dev
```

## License
ISC
