flet-wizards

Templates de wizard multi-step prontos para Flet — autenticação, perfil, onboarding e survey. Cada template é uma @ft.component autocontida com estado reativo, sistema de temas dark/light e callback on_complete tipado.

Instalação

pip install flet-wizards

Requer Python 3.12+ e Flet 0.85+.

Uso rápido

import flet as ft
from flet_wizards import AuthLoginWizard, WizardTheme


@ft.component
def App() -> ft.Control:
    async def handle_login(data: dict) -> None:
        email = data["email"]
        # autenticar...

    return AuthLoginWizard(
        theme=WizardTheme.SLATE,
        on_complete=handle_login,
    )


async def main(page: ft.Page) -> None:
    page.padding = 0
    page.bgcolor = "#0B0B0F"
    page.render(App)


ft.run(main)

Todos os wizards são importados a partir da raiz do pacote:

from flet_wizards import (
    AuthLoginWizard, AuthRegisterWizard, AuthRecoveryWizard, AuthTwoFactorWizard,
    ProfileSetupWizard, ProfileEditWizard, ProfileAvatarWizard,
    OnboardingWalkthroughWizard, SurveyFeedbackWizard,
    WizardTheme,
)

Templates disponíveis

Os wizards AuthTwoFactorWizard, OnboardingWalkthroughWizard e SurveyFeedbackWizard são mobile-first (Android / iOS). Quando abertos em desktop, o PlatformGuard exibe aviso com botão "Continuar mesmo assim".

Temas

A lib expõe 7 pares de temas, cada um em duas variantes (dark e light), totalizando 14 paletas internas. O dev escolhe pelo nome do par:

Uso direto

from flet_wizards import WizardTheme

AuthLoginWizard(theme=WizardTheme.SLATE)        # variante dark
AuthLoginWizard(theme=WizardTheme.SLATE_LIGHT)  # variante light

Detecção automática (dark/light do sistema)

import flet as ft
from flet_wizards import AuthLoginWizard, WizardTheme
from flet_wizards.core import resolve_theme


@ft.component
def App() -> ft.Control:
    page = ft.context.page
    theme = resolve_theme(WizardTheme.SLATE, page.theme_mode)
    return AuthLoginWizard(theme=theme)

resolve_theme(theme, mode) devolve a variante correta:

• ft.ThemeMode.DARK → variante dark do par.
• ft.ThemeMode.LIGHT → variante light do par.
• ft.ThemeMode.SYSTEM → consulta page.platform_brightness e cai em dark como fallback fora de contexto reativo.

Detalhes em docs/themes.md.

Preview local de desenvolvimento

Para inspecionar os wizards visualmente durante o desenvolvimento:

git clone https://github.com/Alisonsantos77/flet-wizards
cd flet-wizards
uv sync
uv run flet run

Abre uma janela com todos os 9 templates lado a lado, com seletor de tema e modo dark/light. O código do preview vive em src/gallery/ e não faz parte do pacote distribuído no PyPI — é apenas ferramenta de inspeção local.

Demo interativa

Veja todos os templates ao vivo no projeto de demonstração:

flet-wizards-gallery

Contribuindo

Veja CONTRIBUTING.md para instruções de como adicionar templates e convenções do projeto.

Licença

MIT © Alison Santos