Back to the catalog

django-modular

Enforces modular Django app structure, file naming conventions, and best practices.

Open source Open in the app JSON README (API)

About

Enforces modular Django app structure, file naming conventions, and best practices.

Details

Kind
Plugins
Topic
No topic detected
Publisher
kshyst
Origin
gemini
Category
ferramentas
Version
0.1.0
Stars
3
Last push
2026-05-18T12:48:25Z
Repository state
ativo
Added
2026-08-30 14:13:39
Updated
2026-08-30 14:13:39
Origin id
kshyst/geminicli-django-modular

README

# Django Modular Skill

This skill enforces a professional, modular architecture for Django applications within the Dark Academia project.

## Features

- **Modular App Structure**: Replaces monolithic `models.py` and `views.py` with dedicated directories (`models/`, `views/`, `serializers/`, `admin/`, `validators/`).
- **Standardized Naming**: Enforces snake_case filenames and PascalCase classes, stripping suffixes like `Serializer` or `ViewSet` from filenames.
- **Fat Model, Thin View**: Encapsulates business logic in models and validation in serializers.
- **Performance Optimization**: Mandates `select_related`, `prefetch_related`, and data loading limits (`only`/`defer`).
- **Production Security**: Hardens environments with SSL, HSTS, secure cookies, and obfuscated admin paths.
- **Modular Settings**: Splits configuration into `base.py`, `development.py`, and `production.py`.

## Contents

- `SKILL.md`: Core agent instructions and triggering logic.
- `references/app_structure.md`: Detailed directory layout rules.
- `references/best_practices.md`: Architectural principles and ORM optimization.
- `references/coding_standards.md`: Formatting, naming, and testing standards.
- `references/performance.md`: Monitoring with Django Debug Toolbar.
- `references/security.md`: Production hardening checklist.
- `references/static_and_media.md`: Asset management and cloud storage guidelines.

## Installation

To install this as a Gemini CLI extension:

```bash
gemini extensions install https://github.com/kshyst/geminicli-django-modular
```

Alternatively, if you have the repository cloned locally:

```bash
gemini extensions install .
```

After installation, the `django-modular` skill will be available in your sessions.

More