Projects vs Apps

In Django, a project is the overall configuration and container for a website, while an app is a self-contained, reusable module inside that project that handles one specific feature (like a blog, a poll, or user accounts).

Learn Projects vs Apps in our free Django course — a beginner-friendly interactive lesson with worked examples, a practice exercise and a quick reference.

Part of the free Django course at LearnCodingFast — hands-on lessons with examples you run in your browser, plus practice exercises and a quick quiz.

In this lesson you'll learn exactly how projects and apps differ, how to create an app, what files Django generates for you, and the one step beginners always forget — registering the app so Django actually uses it.

What You'll Learn in This Lesson

1 Project vs App: The Conceptual Difference

A project is the whole website. It owns the global configuration in settings.py , the root URL routing table in urls.py , and the server entry points ( wsgi.py and asgi.py ). There is exactly one project per site.

An app is a self-contained module that delivers one feature — a blog, a poll, user accounts, a shopping cart. A project can contain many apps, and a single well-built app can be dropped into a completely different project and reused.

• Project — configuration + container. Created with django-admin startproject .
• App — one focused feature. Created with python manage.py startapp .
• Relationship — one project, many apps. Apps live inside the project.

Here is how the two folder structures relate inside a single site:

2 Creating an App with startapp

From inside your project folder (the one containing manage.py ), run the startapp command. Here we create an app named blog :

Django generates a new blog/ folder with these files:

3 Registering the App in INSTALLED_APPS

Creating the app folder is only half the job. Django does not know the app exists until you add it to the INSTALLED_APPS list in settings.py . This single step is the one beginners forget most often.

• Detect the app's models so makemigrations can build tables.
• Load templates from the app's templates/ folder.
• Discover and run the app's tests.
• Pick up any admin registrations in admin.py .

🎯 Your Turn: Register the Right App

Fill in the blank so the new app named polls is added to INSTALLED_APPS .

Common Errors (And How to Fix Them)

❌ My models don't appear / no migrations are created

You ran startapp but forgot to register the app, so Django never sees its models.

✅ Fix: add the app's name to INSTALLED_APPS in settings.py , then run makemigrations .

❌ CommandError: 'blog' conflicts with the name of an existing directory

An app (or folder) called blog already exists, so startapp refuses to overwrite it.

✅ Fix: choose a different app name, or delete/rename the existing folder if it was a mistake.

❌ can't open file 'manage.py': No such file or directory

You ran startapp from the wrong directory — manage.py isn't there.

✅ Fix: cd into the project folder that contains manage.py first, then run the command.

📋 Quick Reference

Term / Command

What It Means

django-admin startproject mysite

Create the project (the whole site)

python manage.py startapp blog

Create an app (one feature) inside the project

INSTALLED_APPS

List in settings.py where you register each app

models.py

Defines an app's database tables

apps.py

Configuration class that names the app

🏆 Mini Challenge: Scaffold a Multi-App Project

Write a helper that prints the commands and the INSTALLED_APPS entries needed to add several apps to a project.

❓ Frequently Asked Questions

Lesson 2 complete — you can structure a Django site!

You now know that a project is the configuration and container while apps are focused, reusable feature modules. You can create an app with startapp , recognise every file it generates, and register the app in INSTALLED_APPS so Django actually uses it.

🚀 Up next: Views & URLs — learn how to map a URL to a view and send a real response to the browser.

Practice quiz

Continue this course

• Previous: Introduction to Django
• Next: Views & URLs