A convenção da pasta static

Seu app precisa de CSS, JavaScript e imagens. O Flask fornece um local padrão para eles: uma pasta chamada static ao lado do seu app. 📁

Por convenção, o Flask disponibiliza automaticamente tudo que está dentro da pasta static; assim, você nunca precisa escrever uma rota para fornecer uma folha de estilos.

Coloque static exatamente ao lado do seu arquivo app.py. O Flask a encontra em relação ao pacote da aplicação, sem nenhuma configuração adicional.

Os arquivos dessa pasta podem ser acessados pelo prefixo de URL /static. Um arquivo chamado style.css fica disponível em /static/style.css no navegador.

Você pode aninhar pastas dentro de static para manter tudo organizado. O caminho no disco corresponde diretamente ao caminho na URL, sem alterações.

Assim, static/css/style.css é fornecido em /static/css/style.css. O caminho no navegador reproduz exatamente a estrutura das suas pastas. 🔗

O nome static é um padrão, não uma regra imutável. O Flask o utiliza, a menos que você indique outra opção, mantendo todos os projetos previsíveis.

Informe static_folder ao criar o app para indicar ao Flask um diretório com outro nome no disco.

Você também pode alterar o prefixo público com static_url_path, para que os recursos apareçam em /files em vez de /static.

Esses arquivos são estáticos porque o Flask os envia como estão, sem executar Python. É exatamente por isso que fornecê-los é tão rápido.

Não coloque em static o HTML que você renderiza. As páginas dinâmicas pertencem a modelos, enquanto static deve conter apenas recursos finalizados e prontos para envio.

Você aprendeu a convenção static: coloque os recursos nessa pasta e o Flask os fornecerá em /static, de forma rápida e automática. Em seguida, você aprenderá a vinculá-los corretamente. ✨