blueprint

Flask Blueprint Generator

Create organized Flask blueprints for modular application structure.

Usage

# Create a new blueprint
flask create-blueprint users
flask create-blueprint api/v1

Blueprint Structure

Generates a complete blueprint with:

• Routes and view functions
• Error handlers
• Template folder structure
• Static file organization

Example Blueprint

# app/blueprints/users/__init__.py
from flask import Blueprint

users_bp = Blueprint(
    'users',
    __name__,
    url_prefix='/users',
    template_folder='templates',
    static_folder='static'
)

from . import routes, models

# app/blueprints/users/routes.py
from flask import render_template, request, redirect, url_for, flash
from . import users_bp
from .models import User
from .forms import UserForm

@users_bp.route('/')
def index():
    """List all users."""
    users = User.query.all()
    return render_template('users/index.html', users=users)

@users_bp.route('/create', methods=['GET', 'POST'])
def create():
    """Create a new user."""
    form = UserForm()
    if form.validate_on_submit():
        user = User(
            username=form.username.data,
            email=form.email.data
        )
        user.save()
        flash('User created successfully!', 'success')
        return redirect(url_for('users.index'))
    return render_template('users/create.html', form=form)

@users_bp.route('/<int:user_id>')
def detail(user_id):
    """Show user details."""
    user = User.query.get_or_404(user_id)
    return render_template('users/detail.html', user=user)

@users_bp.route('/<int:user_id>/edit', methods=['GET', 'POST'])
def edit(user_id):
    """Edit an existing user."""
    user = User.query.get_or_404(user_id)
    form = UserForm(obj=user)
    if form.validate_on_submit():
        user.username = form.username.data
        user.email = form.email.data
        user.save()
        flash('User updated successfully!', 'success')
        return redirect(url_for('users.detail', user_id=user.id))
    return render_template('users/edit.html', form=form, user=user)

@users_bp.route('/<int:user_id>/delete', methods=['POST'])
def delete(user_id):
    """Delete a user."""
    user = User.query.get_or_404(user_id)
    user.delete()
    flash('User deleted successfully!', 'success')
    return redirect(url_for('users.index'))

# Error handlers
@users_bp.errorhandler(404)
def not_found(error):
    return render_template('users/404.html'), 404

@users_bp.errorhandler(500)
def internal_error(error):
    return render_template('users/500.html'), 500