e6e8406d6091e3c32c66b6857acca61db85a0ed7
Removed the initial Django core configuration files (asgi.py, settings, urls.py, wsgi.py) that were originally scaffolded by djinit, as the project's settings have been migrated to the repository root and are no longer needed in the core package. - New Features: - Enhancements: Cleaned up redundant core scaffolding directories. - Bug Fixes:
config
A Django project folder structure is generated with djinitx/djinit/dj.
Features
- Modern project structure with environment-specific settings
- Pre-configured REST API with JWT authentication
- Essential dependencies and utilities
- Production-ready configuration
Setup
Using Just (Recommended)
-
Set environment variables in
.envfile -
Run setup (installs dependencies, runs migrations, creates superuser):
just setup -
Start development server:
just dev
Traditional Method
-
Install dependencies:
pip install -r requirements.txt -
Set environment variables in
.envfile -
Run migrations:
python manage.py migrate -
Create superuser:
python manage.py createsuperuser -
Start development server:
python manage.py runserver
Available Commands
Run just to see all available commands, including:
just dev- Run development serverjust migrate- Run migrationsjust makemigrations- Create migrationsjust createsuperuser- Create superuserjust test- Run testsjust lint- Lint codejust format- Format codejust shell- Django shelljust clean- Clean cache filesjust install <package>- Install packagejust remove <package>- Remove packagejust server- Run production serverjust ci- Run all linting and checksjust test-coverage- Run tests with coverage
Project Structure
config/
├── config/
│ ├── settings/
│ │ ├── base.py
│ │ ├── development.py
│ │ └── production.py
│ ├── admin/
│ ├── api/ # API endpoints organized by model
│ │ ├── user/ # Example: if you have a User model
│ │ │ ├── views.py
│ │ │ ├── serializers.py
│ │ │ └── urls.py
│ │ └── urls.py
│ ├── models/ # Django models
│ ├── tests/
│ ├── urls.py
│ ├── wsgi.py
│ └── asgi.py
├── manage.py
├── requirements.txt
├── pyproject.toml
├── uv.lock
├── .env.sample
└── README.md
**Note:** For the single folder layout, organize your API endpoints by model name under the `api/` directory.
For example, if you have a `User` model in `models/user.py`, create:
- `api/user/views.py` - API views for User
- `api/user/serializers.py` - Serializers for User
- `api/user/urls.py` - URL patterns for User endpoints
See the README files in `api/` and `models/` directories for more details.
API Documentation
When running in development mode, API documentation is available at:
- Swagger UI: http://localhost:8000/docs/
- Schema: http://localhost:8000/schema/
Description
A full-featured, open-source project management system built with Django
Readme
828 KiB
0 Stars
1 Watchers
0 Forks
Languages
HTML
66.1%
Python
33.1%
Just
0.6%
JavaScript
0.1%
Dockerfile
0.1%