This tutorial demonstrates how to configure Django and TailwindCSS from scratch in a new project.
Django Setup
Create a new virtual environment called .venv.
# Windows $ python -m venv .venv $ .venv\Scripts\Activate.ps1 (.venv) $ # macOS/Linux $ python3 -m venv .venv $ source .venv/bin/activate (.venv) $
Then install Django and create a new project called django_project.
(.venv) $ python -m pip install django (.venv) $ django-admin startproject django_project .
Make a project-level templates directory from the command line using the mkdir command.
(.venv) $ mkdir templates
We will store our templates here rather than within each app. However, we need to tell Django where to find them by updating the TEMPLATES configuration in settings.py.
# django_project/settings.py TEMPLATES = [ { ... "DIRS": [BASE_DIR/"templates"], # new ... } ]
Create a templates/base.html file.
<!-- templates/base.html --> <h1 id="Hello-World">Hello, World</h1>
If we cleverly use ' django_project/urls.py ', we can include the view and URLs in one file. Import TemplateView at the top and then set a path that points to the template, base.html.
# django_project/urls.py from django.contrib import admin from django.urls import path from django.views.generic import TemplateView # new urlpatterns = [ path("admin/", admin.site.urls), path("", TemplateView.as_view(template_name="base.html"),), # new ]
Use the runserver command to confirm the homepage is working.
(.venv) $ python manage.py runserver
Tailwind Configuration
The Tailwind docs have an installation guide we can follow with only a few changes. Open a new terminal session from the project directory: we will ultimately need to have two running, one with our Django server and one with Node.
In the new terminal window, make sure you have Node installed on your computer. You can check with node-v.
$ node -v v20.17.0
Create a package.json file to use Node and Tailwind together. Add the -y flag to say yes to all defaults.
$ npm init -y
This is the resulting package.json file.
{ "name": "django-tailwind", "version": "1.0.0", "description": "How to configure Django and Tailwind from scratch in a new project.", "main": "index.js", "scripts": { "test": "echo \"Error: no test specified\" && exit 1" }, "keywords": [], "author": "", "license": "ISC" }
Install Tailwind via npm.
$ npm install -D tailwindcss
This creates a node_modules directory. Next create a tailwind.config.js file.
$ npx tailwindcss init Created Tailwind CSS config file: tailwind.config.js
Now we have a tailwind.config.js file. Add paths to it for our templates directory.
// tailwind.config.js /** @type {import('tailwindcss').Config} */ module.exports = { content: ["./templates/**/"], // updated line here! theme: { extend: {}, }, plugins: [], }
In the Django project, create a static directory and a subdirectory called src.
$ mkdir static $ mkdir static/src
We need to tell Django to look here for files by updating the STATICFILES_DIRS configuration.
# settings.py STATICFILES_DIRS = [BASE_DIR / "static",] # new
Then create a new CSS file called static/src/styles.css and add @tailwind directives to it.
/* static/src/styles.css */ @tailwind base; @tailwind components; @tailwind utilities;
The next step is to start the Tailwind CLI build process. It will scan our template files for classes and build the necessary CSS. We've changed the paths from the Tailwind website slightly here so that it looks in the src/styles.css file and outputs to dist/styles.css.
$ npx tailwindcss -i ./static/src/styles.css -o ./static/dist/styles.css --watch
To try it out, update the base.html template file with some Tailwind classes. It's important to add the load static tag at the top and also link to the new stylesheet. Then, we add basic classes to make the title red and the text below blue.
<!-- templates/base.html --> {% load static %} <link href="%7B%%20static%20'dist/styles.css'%20%%7D" rel="stylesheet"> <h1 id="Hello-World">Hello, World</h1> <p class="text-blue-600">More text</p>
Hard refresh the homepage.
You can see the updates to the text indicating that Tailwind is properly installed.
watch:css Script
We have a basic installation up and running, but you'll soon find that a few extra features improve things significantly.
First, we don't want to remember that big, long command to have Node running. We can put it inside the package.json file as a script that starts with "watch:css."
// package.json { "name": "django-tailwind", "version": "1.0.0", "main": "index.js", "scripts": { "test": "echo \"Error: no test specified\" && exit 1", "watch:css": "npx tailwindcss -i ./static/src/styles.css -o ./static/dist/styles.css --watch" }, "keywords": [], "author": "", "license": "ISC", "description": "", "devDependencies": { "tailwindcss": "^3.4.10" } }
In the terminal where Node is running, stop it with Ctrl+c. Type in npm run watch:css and it should start as before.
$ npm run watch:css
Refresh the webpage to make sure everything still works.
Conclusion
As we've seen, Tailwind works well with Django. For extra goodies, check out django-browser-reload to automatically reload your browser in development so you don't have to do hard refreshes all the time. There is also a well-maintained third-party package, django-tailwind, which provides another approach to integrating Tailwind with Django.
The above is the detailed content of Django Tailwind. For more information, please follow other related articles on the PHP Chinese website!

This tutorial demonstrates creating professional-looking JavaScript forms using the Smart Forms framework (note: no longer available). While the framework itself is unavailable, the principles and techniques remain relevant for other form builders.

The CSS box-shadow and outline properties gained theme.json support in WordPress 6.1. Let's look at a few examples of how it works in real themes, and what options we have to apply these styles to WordPress blocks and elements.

This is the 3rd post in a small series we did on form accessibility. If you missed the second post, check out "Managing User Focus with :focus-visible". In

Building an inline text editor isn't trivial. The process starts by making the target element editable, handling potential SyntaxError exceptions along the way. Creating Your Editor To build this editor, you'll need to dynamically modify the content

If you’ve recently started working with GraphQL, or reviewed its pros and cons, you’ve no doubt heard things like “GraphQL doesn’t support caching” or

The Svelte transition API provides a way to animate components when they enter or leave the document, including custom Svelte transitions.

This article explores the top PHP form builder scripts available on Envato Market, comparing their features, flexibility, and design. Before diving into specific options, let's understand what a PHP form builder is and why you'd use one. A PHP form

This tutorial guides you through building a file upload system using Node.js, Express, and Multer. We'll cover single and multiple file uploads, and even demonstrate storing images in a MongoDB database for later retrieval. First, set up your projec


Hot AI Tools

Undresser.AI Undress
AI-powered app for creating realistic nude photos

AI Clothes Remover
Online AI tool for removing clothes from photos.

Undress AI Tool
Undress images for free

Clothoff.io
AI clothes remover

AI Hentai Generator
Generate AI Hentai for free.

Hot Article

Hot Tools

WebStorm Mac version
Useful JavaScript development tools

SublimeText3 Mac version
God-level code editing software (SublimeText3)

SublimeText3 Chinese version
Chinese version, very easy to use

Safe Exam Browser
Safe Exam Browser is a secure browser environment for taking online exams securely. This software turns any computer into a secure workstation. It controls access to any utility and prevents students from using unauthorized resources.

Dreamweaver Mac version
Visual web development tools
