Enferno Framework - Enferno Documentation

Overview

A Flask framework for developers who ship. No build tools. No configuration maze. Just ./setup.sh && flask run. Enferno combines Flask with Vue 3 and Vuetify 3 — without webpack, vite, or npm. Your AI assistant (Claude Code, Cursor) already knows the codebase thanks to built-in instructions.

Key Features

Zero build step - Vue 3 + Vuetify 3 run directly in browser. No node_modules
Auth that works - 2FA, WebAuthn, OAuth (Google/GitHub) — production code, not a tutorial
SQLite by default - Deploy anywhere. Add PostgreSQL when you need it
AI-native - Ships with Claude Code & Cursor rules
Complexity is opt-in - Redis, Celery, PostgreSQL are optional add-ons

Documentation Sections

Getting Started - Installation and setup guide
Authentication - User management and OAuth setup
Development - Development guidelines and best practices
Deployment - Production deployment guide

OAuth Integration

Supports social login with:

Google (profile and email scope)
GitHub (user:email scope)

Configure in .env:

# Google OAuth
GOOGLE_AUTH_ENABLED=true
GOOGLE_OAUTH_CLIENT_ID=your_client_id
GOOGLE_OAUTH_CLIENT_SECRET=your_client_secret

# GitHub OAuth
GITHUB_AUTH_ENABLED=true
GITHUB_OAUTH_CLIENT_ID=your_client_id
GITHUB_OAUTH_CLIENT_SECRET=your_client_secret

Cursor Rules

Enferno now leverages Cursor Rules for intelligent code assistance and generation. This approach provides:

Context-aware code generation through modern AI-powered IDEs
Codebase-specific guidance tailored to Enferno’s patterns
Improved documentation integrated with development tools
Framework-specific best practices and conventions
More flexible workflow than template-based generation

Rules are organized by domain areas like Vue-Jinja integration and UI components to provide targeted assistance exactly when needed.

Source Code

The source code is available on GitHub.

Contributing

We welcome contributions! Please read our Contributing Guide for details.

​Overview

​Key Features

​Documentation Sections

​OAuth Integration

​Cursor Rules

​Source Code

​Contributing