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.

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.

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

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:

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.

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

❌ 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.

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

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

• Browse all free courses
• Cheat sheets & quizzes
• Coding dictionary