nanodjango

Write a Django site in a single file, using views, models and admin, then automatically convert it to a full Django project when you’re ready for it to grow.

Perfect for experiments, prototypes, tutorials, and small applications.

Contents:

• Getting started
  • Installation
  • Your first app
• Tutorial
  • Initialise nanodjango
  • Create a view
  • Create an API endpoint
  • Create a model
  • Use the model
  • Use the admin site
  • Deploy to production
  • Convert to a full Django project
• Settings
  • Extra settings
• Command usage
  • Run using nanodjango
  • Running your script directly
  • Run using WSGI or ASGI
  • Management commands
• Views
  • Registering routes
  • Return values
  • Additional decorators
  • Async views
• Templates
  • Defining templates
  • Using templates
  • Converting templates
• APIs
  • API decorator
  • Other Ninja features
• Admin
  • Enable the admin site
  • Register a model
  • Custom ModelAdmin
• Converting to a full Django project
  • The convert command
  • How it works
  • Edge cases
• Extending the converter
  • Using your plugin
  • Writing a plugin
• Troubleshooting
  • Settings are not configured
• Contributing
  • Development
  • Running examples
  • Running tests
  • Submitting a PR
  • Merging upstream changes to your fork
  • Building documentation
  • Getting help
  • Thanks
• Changelog
  • 0.10.0 - 2025-02-13
  • 0.9.2 - 2024-10-14
  • 0.9.1 - 2024-09-27
  • 0.9.0 - 2024-09-21
  • 0.8.1 - 2024-09-07
  • 0.8.0 - 2024-09-07
  • 0.7.1 - 2024-06-25
  • 0.7.0 - 2024-06-19
  • 0.6.1 - 2024-06-14
  • 0.6.0 - 2024-05-17
  • 0.5.0 - 2024-05-14
  • 0.4.0 - 2024-04-21
  • 0.3.0 - 2024-04-14
  • 0.2.0 - 2024-04-01
  • 0.1.3 - 2023-10-19
  • 0.1.2 - 2022-11-25
  • 0.1.1 - 2022-11-25
  • 0.1.0 - 2022-11-25