Metadata-Version: 2.4
Name: fleting
Version: 1.1.4
Summary: Micro-framework MVC baseado em Flet para aplicações mobile, tablet e desktop
License: MIT
License-File: LICENSE
Keywords: flet,framework,mvc,ui,desktop,mobile
Author: Alex Yucra
Requires-Python: >=3.11
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.11
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Requires-Dist: flet
Project-URL: Documentation, https://github.com/alexyucra/fleting/tree/main/docs
Project-URL: Homepage, https://github.com/alexyucra/fleting
Project-URL: Issues, https://github.com/alexyucra/fleting/issues
Project-URL: Repository, https://github.com/alexyucra/fleting
Description-Content-Type: text/markdown

<p align="center">
  <a href="README.md">🇧🇷 Português</a> |
  <a href="docs/readme-es.md">🇪🇸 Español</a> |
</p>

---

# ⚡ Fleting Framework

![](docs/img/fleting.png)

Fleting é um micro-framework opinativo construído sobre **Flet**, focado em:
- simplicidade
- organização clara
- produtividade
- aplicações multiplataforma (mobile, tablet e desktop)

Ele traz uma arquitetura inspirada em MVC, com **layout desacoplado**, **roteamento simples**, **i18n**, **responsividade automática** e um **CLI para geração de código**.

## 🚀 Quick Start

### 1. crie um ambiente virtual isolado

- [Recomendado: env com poetry](docs/pt/enviroment.md)


## 🛠️ CLI

```shell
pip install flet
pip install fleting

fleting init
fleting run

# para desenvolvimento
fleting create page home
flet run fleting/app.py
```

## 📚 Documentação

A documentação completa está disponível em:

👉 [documentação completa](docs/pt/index.md)

---

## 🎯 Filosofia

O Fleting foi criado com alguns princípios claros:

### 1️⃣ Simplicidade acima de tudo
- Nada de abstrações desnecessárias
- Código explícito e fácil de entender
- Arquitetura previsível

### 2️⃣ Separação de responsabilidades
- **View** → UI pura (Flet)
- **Layout** → Estrutura visual reutilizável
- **Controller** → Regras de negócio
- **Model** → Dados
- **Router** → Navegação
- **Core** → Infraestrutura do framework

### 3️⃣ Mobile-first
- O estado global da aplicação identifica automaticamente:
  - `mobile`
  - `tablet`
  - `desktop`
- Layouts podem reagir dinamicamente ao tipo de dispositivo

### 4️⃣ Internacionalização nativa
- Sistema de tradução simples baseado em JSON
- Mudança de idioma em tempo real
- Traduções acessíveis em qualquer parte da app

### 5️⃣ CLI como cidadão de primeira classe
- Criação e remoção de arquivos padronizados
- Redução de boilerplate
- Convenção > Configuração

---

## 📄 Licença

MIT

## Como contribuir
- [Para quem quiser contribuir com o Fleting no GitHub.](CONTRIBUTING.md)
