`youtube:https://www.youtube.com/embed/UBOj6rqRUME` [Tailwind CSS][tailwind] provides a gazillion-ish [utility][tailwind-utility] and helper classes that you can choose from to build your UI without having to write much CSS. When you build your app, post CSS will scan your files for class names and then generate a new static stylesheet with only the used class names. The claim to fame is that it is fast, flexible, and reliable with zero-runtime. ### Install [Install][tailwind-install] Tailwind CSS using PostCSS because you are using Webpack in our CRA app. You will need to install `tailwindcss` and its peer dependencies as dev dependencies via npm. It will automatically create a `tailwind.config.js` file for you. > There are many guides to help you install the dependency. > Follow the guide that matches the type of project you created. ```bash:title=bash npm install -D tailwindcss postcss autoprefixer npx tailwindcss init ``` > You will need to restart the server because you have installed new dependencies. ### Configure PostCSS Add `tailwindcss` and `autoprefixer` to your `postcss.config.js` file. ```bash:title=bash touch postcss.config.js ``` ```js:title=./postcss.config.js module.exports = { plugins: { tailwindcss: {}, autoprefixer: {}, } } ``` ### Configure template paths Add the paths to all of your template files in your `tailwind.config.js` file. This path will provide the list of files that need to be scanned for the great Tailwind purge of unused classes. ```js:title=./tailwind.config.js /** @type {import('tailwindcss').Config} */ module.exports = { content: ["./src/**/*.{html,js}"], theme: { extend: {}, }, plugins: [], } ``` ### Configure style sheet Add the `@tailwind` directives for each of Tailwind’s layers to your main CSS file. ```bash:title=bash touch ./src/styles.css ``` ```css:title=./src/styles.css @tailwind base; @tailwind components; @tailwind utilities; ``` Now that you have styles, you need to reference them in our HTML file. ```js:title=./src/App.js import './styles.css'; ``` ### Optimize for production You would want to get the most performance out of your project by [optimizing][tailwind-prod] for production. Tailwind recommends minifying your CSS with a tool like [cssnano][cssnano], and compressing your CSS with [Brotli][brotli] for the smallest possible production build. If you’re using Tailwind CLI, you can minify your CSS by adding the `--minify` flag: ```bash:title=bash npx tailwindcss -o build.css --minify ``` If you’ve installed Tailwind as a PostCSS plugin, add `cssnano` to the end of your plugin list: ```js:title=./postcss.config.js module.exports = { plugins: { tailwindcss: {}, autoprefixer: {}, ...(process.env.NODE_ENV === 'production' ? { cssnano: {} } : {}) } } ``` ## Stuck? Setting up Tailwind with PostCSS can be a tricky across different build tools. Check out their [framework guides][tailwind-stuck] to see if they have more specific instructions for your particular setup. ## Prettify the app You are going to start using Tailwind's [utility][tailwind-utility] classes to make things pretty. Reconstruct the `./src/App.js` component by applying the following styling: - The container div will have a background color, some padding and grow to the full height of the screen. - A `flex` form lets you make the textbox a width of 100% with `w-full` and put the Add button next to it. - Use `truncate` to truncate overflowing text with an ellipsis (…) if needed. ```jsx:title=./src/App.js

{/* The rest of the components go here */}

``` Time to spruce up the errors below the `flex` box. If there are `errors` a div with some color, padding, center aligned and bottom margin is rendered with a bold strong tag. ```jsx:title=./src/App.js {error && (

Something went wrong! {error}

)} ``` Fancy up the display that indicates that there are no todo tasks available at this time. ```jsx:title=./src/App.js {todos?.length === 0 && (

There is nothing to do.

)} ``` Give each todo task in the collection some eye-candy TLC. ```jsx:title=./src/App.js {todos?.map((todo) => { return (

toggle(todo)} /> {/* Strike through text when the todo task is flagged as completed. */} {todo.text}

{todo.created}

{todo.id}

); })} ``` ## Checkboxes To make the checkboxes funky, install and import the `@tailwindcss/forms` plugin. ```bash:title=bash npm install -D @tailwindcss/forms ``` ```js:title=./tailwind.config.js /** @type {import('tailwindcss').Config} */ module.exports = { content: ['./src/**/*.{html,js}'], theme: { extend: {}, }, plugins: [ require('@tailwindcss/forms') // <------ ], }; ``` Style each checkbox. ```js:title=./src/App.js toggle(todo)} className="w-8 h-8 mr-2 text-green-500 focus:ring-green-400 focus:ring-opacity-25 border border-gray-300 rounded cursor-pointer" /> ``` Style the container with `flex items-center` to vertically align the items in the middle. ```jsx:title=./src/App.js toggle(todo)} className="w-8 h-8 mr-2 text-green-500 focus:ring-green-400 focus:ring-opacity-25 border border-gray-300 rounded cursor-pointer" /> {todo.text} ``` ## Heading Now squash the form, put it in the center of the page and give it a heading. ```html:title=./src/App.js

✅ My awesome task list

``` :vulcan: You are now fully equipped to build kick-ass front ends using Tailwind CSS. :woman_singer: ## Date Show a formatted date using plain old JavaScript. Create the following function. ```js:title=./src/App.js const formatDate = (date) => { const dtFormat = new Intl.DateTimeFormat('en', { timeZone: 'UTC', weekday: 'short', year: '2-digit', month: 'short', day: '2-digit', hour: '2-digit', minute: '2-digit', }); // Example: Mon, Oct 24, 22, 06:08 AM return dtFormat.format(new Date(date)); }; ``` Update the created date display by passing it into the newly created function. ```jsx:title=./src/App.js

{formatDate(todo.created)}

``` ## Progress indicators Show your users when processes have kicked off and things are working. Create a spinner component. For simplistic purposes, keep it in App.js for now. ```jsx:title=./src/App.js const Spinner = ({ text }) => { return ( {text}... ); }; ``` ### Display the spinner in the User Interface You can just replace the existing file using the code below. ```jsx:title=./src/App.js import React, { useEffect, useRef, useState } from 'react'; import api from './api'; import './styles.css'; const formatDate = (date) => { const dtFormat = new Intl.DateTimeFormat('en', { timeZone: 'UTC', weekday: 'short', year: '2-digit', month: 'short', day: '2-digit', hour: '2-digit', minute: '2-digit', }); return dtFormat.format(new Date(date)); }; const Spinner = ({ text }) => { return ( {text}... ); }; const App = () => { const [todos, setTodos] = useState([]); const [error, setError] = useState(); // In this implementation there are two places where the spinners will display. // One boolean global spinner to indicate when items are being fetched as to not // show any todo tasks or text saying that tasks cannot be found. const [showGlobalSpinner, toggleGlobalSpinner] = useState(false); // The other object task spinner to indicate when items are being interacted on // via the API by executing specific actions. This one is more complicated // because based on the ID and action, it can display the spinner in different // locations. Example: display the spinner over the checkbox when // a user clicks on the toggle completion checkbox. const [taskSpinner, toggleTaskSpinner] = useState(); const textbox = useRef(); const setAndSortTodos = (items) => { setTodos(items.sort((x, y) => y.created - x.created)); }; const tryInteractWithApi = (interaction, errorMessage) => { try { return interaction(); } catch (e) { setError(errorMessage); console.error(errorMessage, e); } }; useEffect(() => { const loadTodos = async () => { // Tell the User Interface to start indicating the fetch has started. toggleGlobalSpinner(true); const result = await tryInteractWithApi( api.getTodos, 'We could not get your tasks at this time.', ); setAndSortTodos(result); // Indicate that the fetch is complete. toggleGlobalSpinner(false); }; loadTodos(); }, []); const add = async () => { const task = textbox.current.value; if (task) { toggleTaskSpinner({ action: 'create' }); const result = await tryInteractWithApi( () => api.createTodo(task), `We could not add your task: ${task}.`, ); if (result) { setAndSortTodos([...todos, result]); textbox.current.value = ''; } toggleTaskSpinner(); } }; const remove = async (id) => { toggleTaskSpinner({ id, action: 'delete' }); const result = await tryInteractWithApi( () => api.deleteTodo(id), `We could not delete your task ${id}.`, ); if (result) { setAndSortTodos(todos.filter((t) => t.id !== id)); } toggleTaskSpinner(); }; const toggle = async (todo) => { const updatedTodo = { ...todo, completed: !todo.completed, }; toggleTaskSpinner({ id: todo.id, action: 'toggle' }); const result = await tryInteractWithApi( () => api.updateTodo(updatedTodo), `We could not toggle your task ${todo.id}`, toggleTaskSpinner, ); if (result) { setAndSortTodos(todos.map((t) => (t.id === todo.id ? updatedTodo : t))); } toggleTaskSpinner(); }; return (

✅ My awesome task list

{showGlobalSpinner && (

)} {taskSpinner?.action === 'create' && (

)} {error && (

Something went wrong! {error}

)} {!showGlobalSpinner && todos?.length === 0 && (

There is nothing to do.

)} {!showGlobalSpinner && todos?.map((todo) => { return (

{taskSpinner?.id === todo.id && taskSpinner?.action === 'delete' && ( )} {taskSpinner?.id !== todo.id && taskSpinner?.action !== 'delete' && ( )} {taskSpinner?.id === todo.id && taskSpinner?.action === 'toggle' && ( )} {taskSpinner?.id !== todo.id && ( toggle(todo)} className="w-8 h-8 mr-2 text-green-500 focus:ring-green-400 focus:ring-opacity-25 border border-gray-300 rounded cursor-pointer" /> )} {todo.text}

{formatDate(todo.created)}

{todo.id}

); })}

); }; export default App; ``` ## References - [Tailwind CSS][tailwind] - [Setup Tailwind CSS in your Editor][tailwind-editor] - [Get unstuck with Tailwind CSS][tailwind-stuck] [tailwind]: https://tailwindcss.com/ [tailwind-install]: https://tailwindcss.com/docs/installation/using-postcss [tailwind-stuck]: https://tailwindcss.com/docs/installation/framework-guides [tailwind-editor]: https://tailwindcss.com/docs/editor-setup [tailwind-prod]: https://tailwindcss.com/docs/optimizing-for-production [tailwind-utility]: https://tailwindcss.com/docs/utility-first [cssnano]: https://cssnano.co/ [brotli]: https://en.wikipedia.org/wiki/Brotli