⚡

Backend, Done

FastAPI application factory with CORS, JWT auth middleware, and RBAC built in. Automatic CRUD routers, module auto-loading, SQLAdmin back-office at /admin/, and Alembic migrations — all wired up from one function call.

🖥️

Frontend, Included

@veloiq/ui renders schema-driven CRUD pages with side panels, Miller columns tree view, a relations explorer graph, auto-generated analysis charts, bulk actions, dark mode, and global search — with zero boilerplate.

🔓

Your Code, Always

VeloIQ is a pro-code framework, not a black box. Every FastAPI endpoint and React component is plain Python and TypeScript you own, read, and extend. The generated code stays yours.

Two models. Full stack.

Define your models.
Everything else is generated.

Drop a models.py in any module folder. VeloIQ auto-generates the REST API, the admin views, and the TypeScript schema for the React frontend — including the relationship between your models.

• ✓ CRUD endpoints for both models
• ✓ React pages with side panels and relation explorer
• ✓ SQLAdmin back-office with the relation wired up
• ✓ TypeScript types auto-generated from Python models

app/modules/projects/models.py

from typing import List, Optional
from sqlmodel import Field
from veloiq_framework import TimestampedModel, jm_relationship

class TeamMember(TimestampedModel, table=True):
    __tablename__ = "team_member"
    name: str
    email: str
    role: str = "member"
    projects: List["Project"] = jm_relationship(
        back_populates="owner"
    )

class Project(TimestampedModel, table=True):
    __tablename__ = "project"
    name: str
    status: str = "active"
    owner_id: Optional[int] = Field(
        default=None, foreign_key="team_member.id"
    )
    owner: Optional["TeamMember"] = jm_relationship(
        back_populates="projects"
    )

🔐 Access Control

• ✓

  Three-layer RBAC

  Global role permissions → per-model exceptions → per-field exceptions. Configurable at runtime through the admin UI.

• ✓

  ReBAC row-level filtering

  Users see only the rows they own or belong to. Relationship traversal via rebac_subquery() with cycle detection.

• ✓

  JWT authentication

  Built-in login endpoint, token refresh, and middleware. No third-party auth service required.

• ✓

  User / Role / Tenant management

  Full React UI for managing users, roles, and tenants. Comes pre-wired with the framework.

• ✓

  Multi-database support

  PostgreSQL, MySQL, SQLite, or any SQLAlchemy-compatible database. Switch with one environment variable.

🖥️ Intelligent UI

• ✓

  Side panels

  Click any list row to open a detail panel alongside the list. Drag to resize, minimize, maximize, or pop out to full page.

• ✓

  Miller columns tree view

  Hierarchical parent/child data renders as an interactive multi-column browser. Auto-detected from self-referential model relationships.

• ✓

  Relations explorer

  Visual graph of all records connected to any entity. Click any node to navigate directly to it.

• ✓

  Analysis charts

  Distribution and summary charts appear automatically on relation tables. Toggle per view, preference saved per user.

• ✓

  Bulk actions, column config, dark mode

  Select rows for bulk edit, delete, or CSV export. Show/hide/reorder columns. Light and dark mode with keyboard shortcuts.

$ git clone https://github.com/cesarlugos1s/veloiq.git
$ cd veloiq
$ bash samples/task-manager/quickstart.sh