add-web-route

Add permission-protected FastAPI admin CRUD routes with Jinja2 templates.

Updated Feb 3, 2026
One-click install
npx skills add https://github.com/michaelayoade/dotmac_crm --skill add-web-route
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: add-web-route
Source: https://github.com/michaelayoade/dotmac_crm/tree/main/.claude/skills/add-web-route
Command: npx skills add https://github.com/michaelayoade/dotmac_crm --skill add-web-route

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

It helps you quickly add a complete, server-rendered admin web route so your CRM modules have working list/new/detail/edit/delete pages, consistent templates, and sidebar navigation.

Core Features & Use Cases

  • Domain-colored module routing: Selects the correct domain color pair (Tailwind) for the target module (e.g., Customers, Tickets, Network) to keep the admin UI consistent.
  • Full CRUD route scaffolding: Creates FastAPI endpoints for listing, creating, viewing details, editing, updating, and deleting admin resources with permission guards.
  • Template + navigation integration: Adds the required Jinja2 templates and sidebar link patterns so the module appears in the admin navigation with correct permission checks.
  • HTMX-ready UI conventions: Establishes a UI checklist (macros usage, status badges, responsive tables, confirmation patterns) to support modern dynamic admin interactions.

Quick Start

Ask the AI to scaffold the FastAPI admin route for a given module name and route_info, including the router registration, Jinja templates, sidebar link, and a permission-protected CRUD flow.

Frequently Asked Questions about add-web-route

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I scaffold a secure FastAPI admin route with CRUD operations and Jinja2 templates?

Scaffolding a secure FastAPI admin route with CRUD operations and Jinja2 templates involves generating permission-protected list, new, detail, edit, update, and delete endpoints, then wiring them into the admin router and sidebar navigation with can_{module} checks.

How do I add permission guards to FastAPI admin routes for a CRM module?

Adding permission guards to FastAPI admin routes secures module endpoints by applying can_{module} checks during router setup, ensuring only authorized users access the list, edit, and delete actions.

How do I integrate HTMX-ready UI conventions into FastAPI admin routing?

Integrating HTMX-ready UI conventions into FastAPI admin routing requires applying a UI/UX checklist that utilizes Jinja2 macros, status_badge implementations, responsive table handling, and confirmation patterns for dynamic interactions.

Does FastAPI admin routing support domain-colored sidebar navigation for different CRM modules?

Yes, FastAPI admin routing supports domain-colored sidebar navigation by selecting the correct Tailwind domain color pair for target modules like Customers or Tickets, updating sidebar links to maintain consistent admin UI styling.

Can I generate a complete server-rendered admin CRUD web route without manually creating Jinja2 templates?

Yes, you can generate a complete server-rendered admin CRUD web route that automatically creates the required Jinja2 templates, sidebar link patterns, and FastAPI endpoints, eliminating manual template creation.

What is needed to set up FastAPI admin routing for DotMac Omni CRM modules?

Setting up FastAPI admin routing for DotMac Omni CRM modules requires a FastAPI router configured under app/web/admin/{module}.py, Jinja2Templates rendering configured, and adherence to the provided UI/UX checklist for consistent UI generation.