> ## Documentation Index
> Fetch the complete documentation index at: https://docs.enferno.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Enferno Framework

> A Flask framework for developers who ship

## 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](/getting-started) - Installation and setup guide
* [Authentication](/authentication) - User management and OAuth setup
* [Development](/development) - Development guidelines and best practices
* [Deployment](/deployment) - Production deployment guide

## OAuth Integration

Supports social login with:

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

Configure in `.env`:

```bash theme={null}
# 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](https://github.com/level09/enferno).

## Contributing

We welcome contributions! Please read our [Contributing Guide](https://github.com/level09/enferno/blob/master/CONTRIBUTING.md) for details.