search
Django TailwindAug 29, 2024 am 06:30 AM

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

Django Tailwind

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.

Django Tailwind

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!

Statement
The content of this article is voluntarily contributed by netizens, and the copyright belongs to the original author. This site does not assume corresponding legal responsibility. If you find any content suspected of plagiarism or infringement, please contact admin@php.cn
Demystifying Screen Readers: Accessible Forms & Best PracticesDemystifying Screen Readers: Accessible Forms & Best PracticesMar 08, 2025 am 09:45 AM

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

Create a JavaScript Contact Form With the Smart Forms FrameworkCreate a JavaScript Contact Form With the Smart Forms FrameworkMar 07, 2025 am 11:33 AM

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.

Adding Box Shadows to WordPress Blocks and ElementsAdding Box Shadows to WordPress Blocks and ElementsMar 09, 2025 pm 12:53 PM

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.

Working With GraphQL CachingWorking With GraphQL CachingMar 19, 2025 am 09:36 AM

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

Making Your First Custom Svelte TransitionMaking Your First Custom Svelte TransitionMar 15, 2025 am 11:08 AM

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

Classy and Cool Custom CSS Scrollbars: A ShowcaseClassy and Cool Custom CSS Scrollbars: A ShowcaseMar 10, 2025 am 11:37 AM

In this article we will be diving into the world of scrollbars. I know, it doesn’t sound too glamorous, but trust me, a well-designed page goes hand-in-hand

Show, Don't TellShow, Don't TellMar 16, 2025 am 11:49 AM

How much time do you spend designing the content presentation for your websites? When you write a new blog post or create a new page, are you thinking about

What the Heck Are npm Commands?What the Heck Are npm Commands?Mar 15, 2025 am 11:36 AM

npm commands run various tasks for you, either as a one-off or a continuously running process for things like starting a server or compiling code.

See all articles

Hot AI Tools

Undresser.AI Undress

Undresser.AI Undress

AI-powered app for creating realistic nude photos

AI Clothes Remover

AI Clothes Remover

Online AI tool for removing clothes from photos.

Undress AI Tool

Undress AI Tool

Undress images for free

Clothoff.io

Clothoff.io

AI clothes remover

AI Hentai Generator

AI Hentai Generator

Generate AI Hentai for free.

Hot Tools

SublimeText3 English version

SublimeText3 English version

Recommended: Win version, supports code prompts!

DVWA

DVWA

Damn Vulnerable Web App (DVWA) is a PHP/MySQL web application that is very vulnerable. Its main goals are to be an aid for security professionals to test their skills and tools in a legal environment, to help web developers better understand the process of securing web applications, and to help teachers/students teach/learn in a classroom environment Web application security. The goal of DVWA is to practice some of the most common web vulnerabilities through a simple and straightforward interface, with varying degrees of difficulty. Please note that this software

mPDF

mPDF

mPDF is a PHP library that can generate PDF files from UTF-8 encoded HTML. The original author, Ian Back, wrote mPDF to output PDF files "on the fly" from his website and handle different languages. It is slower than original scripts like HTML2FPDF and produces larger files when using Unicode fonts, but supports CSS styles etc. and has a lot of enhancements. Supports almost all languages, including RTL (Arabic and Hebrew) and CJK (Chinese, Japanese and Korean). Supports nested block-level elements (such as P, DIV),

Notepad++7.3.1

Notepad++7.3.1

Easy-to-use and free code editor

PhpStorm Mac version

PhpStorm Mac version

The latest (2018.2.1) professional PHP integrated development tool