Tutorial

This tutorial walks you through building a complete blog application with Buraq — models, views, forms, templates, and authentication.

What you’ll build: A blog with posts, categories, comments, and user authentication.

Parts

1. Models — Define your data with Buraq ORM
2. Views & URLs — Handle requests with FBVs and CBVs
3. Forms — Validate user input with Form and ModelForm
4. Templates — Render HTML with Jinja2
5. Authentication — Protect views with JWT auth

Prerequisites

• Python 3.11+
• Buraq installed (see Installation)
• Basic Python and async/await knowledge

Setup

buraq startproject buraq_blog
cd buraq_blog

uv sync
source .venv/bin/activate        # Windows: .venv\Scripts\activate

buraq startapp posts

Add "posts" to INSTALLED_APPS in config/settings.py.