Framefox

🦊 Python web framework that makes development enjoyable - FastAPI + MVC + SQLModel + Interactive CLI. Ship fast without sacrificing quality.

Generate Convert Improve

Install / Use

/learn @soma-smart/Framefox

About this skill

Quality Score

0/100

README

Framefox Logo

🦊 Framefox

Swift, smart, and a bit foxy!

The Python web framework that makes development enjoyable and productive

🚀 Quick Start • 📖 Documentation • 🎯 Examples • 💬 Contact • 🤝 Contributing

</div>

🌟 Why Framefox?

Framefox combines the speed of FastAPI with clean MVC architecture, type-safe SQLModel, robust Pydantic validation, and developer-friendly tooling. Built for developers who want to ship fast without sacrificing code quality.

✨ What makes it special?

🎯 MVC Architecture - Clean separation with Controllers, Templates, and Repositories
🏗️ Interactive CLI - Generate components instantly with framefox create
⚡ FastAPI Foundation - Built on FastAPI with async support out of the box
🗄️ SQLModel Integration - Type-safe database models with automatic validation
📋 Pydantic Validation - Robust data validation and serialization everywhere
🔒 Security First - CSRF protection, XSS prevention, and secure authentication
🧠 Developer Friendly - Jinja2 templates, hot reload, and comprehensive debugging
📱 Modern Stack - Python 3.12+, async/await, dependency injection everywhere

Un petit mot en français

Framefox est bien un outils de l'hexagone 🇫🇷 N'hesitez pas à communiquer avec nous directement en français pour toute questions (de préférence sur linkedin). Une version de la documentation en français est également prévu !

Demo

🚀 Quick Start

Get a full web application running in 30 seconds:

# Install Framefox
pip install framefox

# Init your project
framefox init

# Start developing
framefox run

That's it! 🎉 Your app is running on http://localhost:8000

🎯 Examples

💨 Controllers with Routes

from framefox.core.routing.decorator.route import Route
from framefox.core.controller.abstract_controller import AbstractController

class UserController(AbstractController):
    
    @Route("/users", "user.index", methods=["GET"])
    async def index(self):
        users = await self.user_repository.find_all()
        return self.render("user/index.html", {"users": users})
    
    @Route("/users/{id}", "user.show", methods=["GET"])
    async def show(self, id: int):
        user = await self.user_repository.find(id)
        return self.render("user/show.html", {"user": user})

🎨 Jinja2 Templates with Built-in Functions

<!-- templates/user/index.html -->
<!DOCTYPE html>
<html>
<head>
    <title>Users</title>
    <link href="{{ asset('css/app.css') }}" rel="stylesheet">
</head>
<body>
    <h1>Users</h1>
    
    {% for user in users %}
        <div class="user-card">
            <h3>{{ user.name }}</h3>
            <a href="{{ url_for('user.show', id=user.id) }}">View Profile</a>
        </div>
    {% endfor %}
</body>
</html>

🏗️ Architecture That Scales

my-project/
├── src/
│   ├── 🎮 controllers/     # Handle HTTP requests and business logic
│   ├── 🏛️ entity/          # Database models and entities  
│   ├── 📝 form/           # Form types and validation
│   └── 🗄️ repository/     # Data access layer
├── 🎨 templates/          # Jinja2 templates with template inheritance
├── ⚙️ config/             # YAML configuration files
├── 🌐 public/            # Static assets (CSS, JS, images)
└── 📋 main.py            # Application entry point

Clean MVC separation means your code stays maintainable as your team and project grow.

🔥 Core Features

🚄 Performance

FastAPI foundation
Async/await support
Built-in template caching
Dependency injection container
Repository pattern for data access

🛡️ Security

CSRF token generation
XSS prevention in templates
Secure session management
User authentication system
Role-based access control

</td> <td width="50%">

🧰 Developer Experience

Interactive CLI commands
Component generators
Hot reload development server
Comprehensive error pages
Built-in profiler and debugger

🗃️ Database & ORM

SQLModel integration for type safety
Pydantic validation everywhere
Entity-Repository pattern
Database migrations with Alembic
Relationship mapping
Query builder integration
Multi-database support

</td> </tr> </table>

🛠️ Interactive CLI

Framefox includes a powerful CLI for rapid development:

# Generate components instantly
framefox create controller
framefox create entity
framefox create crud       # Full CRUD with templates

# Database management
framefox database create-migration
framefox database upgrade

# Development tools
framefox run            # Start development server
framefox debug router       # List all routes
framefox cache clear        # Clear application cache

🎨 Template System

Framefox uses Jinja2 with powerful built-in functions:

🔧 Built-in Template Functions

{{ url_for('route.name', param=value) }} - Generate URLs from route names
{{ asset('path/file.css') }} - Asset management with versioning
{{ csrf_token() }} - CSRF protection
{{ current_user }} - Access authenticated user
{{ get_flash_messages() }} - Session-based notifications

🏗️ Template Inheritance

<!-- base.html -->
<!DOCTYPE html>
<html>
<head>
    <title>{% block title %}My App{% endblock %}</title>
    <link href="{{ asset('css/app.css') }}" rel="stylesheet">
</head>
<body>
    <nav>
        <!-- Navigation with authentication -->
        {% if current_user %}
            <span>Welcome, {{ current_user.name }}!</span>
        {% endif %}
    </nav>
    
    <main>
        {% block content %}{% endblock %}
    </main>
</body>
</html>

📚 Learn More

| 📖 Resource | 🎯 Perfect For | | ---------------------------------------------------------------------------------------- | ------------------------------- | | 📋 Installation Guide | Getting up and running | | 🎮 Controllers Guide | Building your application logic | | 🎨 Templates Guide | Creating beautiful views | | 🔐 Security Guide | Securing your application | | 🚀 Deployment Guide | Going to production |

💬 Contact

Need help or have questions? Contact us directly!

</div>

💼 Company LinkedIn: SOMA Smart
👤 Rayen BOUMAZA: LinkedIn
👤 Raphaël LEUROND: LinkedIn
📖 Documentation: soma-smart.github.io

🤝 Contributing

We ❤️ contributors! Here's how you can help:

🆕 For New Contributors

🍴 Fork the repository
🌿 Create a feature branch: git checkout -b feature/amazing-feature
💾 Commit your changes: git commit -m 'Add amazing feature'
📤 Push to the branch: git push origin feature/amazing-feature
🔄 Open a Pull Request

🎯 Good First Issues

📝 Improve documentation
🐛 Fix small bugs
✨ Add examples
🧪 Write tests

For any questions about contributing, feel free to contact us directly on LinkedIn!

🏆 Support the Project

If Framefox helps you build amazing things:

⭐ Star this repository
🐦 Share on social media
📝 Write a blog post
🔗 Share with friends

Your support means the world to us! 🙏

📈 Star History

Follow our journey and see how Framefox is growing with the community

Each star motivates us to improve Framefox further! ⭐

</div>

🛣️ Roadmap

🚧 What's Coming Next

Framefox is actively developed with exciting features on the horizon!

</div>

In Progress

Advanced Testing Suite - Built-in testing utilities and fixtures (we know Framefox lack of more tests)
Internationalization (i18n) - Multi-language support with automatic translation management
WebSocket Support - Real-time features wit

Related Skills

node-connect

334.9k

Diagnose OpenClaw node connection and pairing failures for Android, iOS, and macOS companion apps

claude-opus-4-5-migration

82.3k

Migrate prompts and code from Claude Sonnet 4.0, Sonnet 4.5, or Opus 4.1 to Opus 4.5

frontend-design

82.3k

Create distinctive, production-grade frontend interfaces with high design quality. Use this skill when the user asks to build web components, pages, or applications. Generates creative, polished code that avoids generic AI aesthetics.

model-usage

334.9k

Use CodexBar CLI local cost usage to summarize per-model usage for Codex or Claude, including the current (most recent) model or a full model breakdown. Trigger when asked for model-level usage/cost data from codexbar, or when you need a scriptable per-model summary from codexbar cost JSON.

soma-smart

View profile

View on GitHub

GitHub Stars202

CategoryDevelopment

Updated1mo ago

Forks18

soma-smart/framefox

Languages

Python

Security Score

100/100

Audited on Feb 9, 2026

No findings