Skip to main content

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

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.