🚀 Django Kick Start 🚀

A powerful VS Code extension for seamless Django project initialization and management

Django Kick Start

A VS Code extension providing a beginner-friendly Django project setup experience with one-click initialization and smart automation tools.

🎥 Demo

✨ Feature Demonstrations ✨

Create Migration

Initialize Project

Generate App

Static Helper

Template Scaffolding

Create HTML

Create Static

Run Server with F5

🎯 Features

1. Project Wizard (One-click Django Setup)

• Interactive project creation with validation
• Automatic environment checks (Python & Django)
• Default app creation and configuration
• Pre-configured URLs and views
• Initial database setup

2. App Generation

• Customizable app name (default: 'myapp')
• Automatic app registration in INSTALLED_APPS
• Pre-configured URL patterns
• Basic view setup with welcome page

3. Static Files Helper

• Automatic creation of static file structure
• Configuration of static and media files in settings.py
• Setup of development media serving
• Sample CSS file with basic styles
• Proper static file organization (css, js, images)

4. Template Scaffolding

• Bootstrap-powered base template
• Responsive navigation bar
• User authentication templates
• Dashboard layout
• Mobile-friendly design
• Custom block structure

🚀 Quick Start

1. Install the extension from VS Code Marketplace
2. Press Ctrl+Shift+P (or Cmd+Shift+P on Mac)
3. Type "Django" to see available commands:
   • "Django: Initialize New Project" - Create new project
   • "Django: Generate New App" - Add new app
   • "Django: Setup Static Files" - Configure static files
   • "Django: Scaffold Templates" - Set up templates
   • "Django: Run Development Server" - Start development server

Debugging Your Project

You can start the development server in three ways:

1. Using the Command Palette:

   • Press Ctrl+Shift+P (or Cmd+Shift+P on Mac)
   • Type "Django: Run Development Server"
   • Choose between "Run Server" or "Debug Server" mode
   • The server will start in a new terminal

2. Using VS Code Debug (F5):

   • Press F5 or click the "Run and Debug" button
   • Select one of these configurations:
     • "Django: Run Server" - For normal development
     • "Django: Debug Server" - For debugging with breakpoints
   • The server will start with appropriate settings

3. Using the Run Button:

   • Click the "Run and Debug" button in the sidebar
   • Select the desired configuration
   • Click the green play button

Debug Mode Tips:

• Use "Django: Debug Server" when you need to set breakpoints
• The --noreload flag is automatically added in debug mode
• Breakpoints will work in your views, models, and other Python files
• The debug console will show Django's output and any print statements

The server will run on http://127.0.0.1:8000/ by default.

⚙️ Requirements

• Visual Studio Code ^1.85.0
• Python 3.8 or higher
• Django (will be installed automatically if missing)

📋 Command Reference

🔄 Project Structure

your-project/
├── manage.py
├── your_project/
│   ├── __init__.py
│   ├── settings.py
│   ├── urls.py
│   └── wsgi.py
├── myapp/
│   ├── __init__.py
│   ├── admin.py
│   ├── apps.py
│   ├── models.py
│   ├── urls.py
│   └── views.py
├── static/
│   ├── css/
│   │   └── style.css
│   ├── js/
│   └── images/
├── media/
└── templates/
    ├── base.html
    ├── home.html
    ├── login.html
    └── dashboard.html

🤝 Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

📝 License

This project is licensed under the MIT License - see the LICENSE file for details.

🐛 Known Issues

See the issue tracker for current issues.

What's New in 1.1.3

View and URL Creation

• Added new Django: Create View and URL command
• Create views with HTTP response
• Automatic URL pattern configuration
• View name validation
• URL pattern validation
• No HTML template creation

Enjoy! 🎉