Skip to content
+

Toolpad Core - Tutorial

Learn how to use Toolpad Core through an illustrative example dashboard.

Bootstrapping


  1. To choose a project name and create a basic project for this tutorial, run:
npx create-toolpad-app@latest --example tutorial
  1. To start the basic project on http://localhost:3000, run:
cd <project-name> npm install && npm run dev
  1. The following splash screen appears:
Toolpad Core entry point

Starting with Toolpad Core

  1. The app has two pages already created in a dashboard layout, with routing, breadcrumbs and theming already set up:

Create a new page


  1. To add a new page and make it appear in the sidebar navigation, create a new folder within the (dashboard) directory titled page-2 and add the following content to page.tsx inside it:
./(dashboard)/page-2/page.tsx
import Typography from '@mui/material/Typography'; export default function Home() { return ( <Typography variant="h6" color="grey.800"> This is page 2! </Typography> ); } 
  1. Add the newly created page to the sidebar navigation by adding the following code to the navigation items array in app/layout.tsx:
app/layout.tsx
// Add the following import: import TimelineIcon from '@mui/icons-material/Timeline'; // ... const NAVIGATION: Navigation = [ // Add the following new item: { segment: 'page-2', title: 'Page 2', icon: <TimelineIcon />, }, ]; 

The newly created page can now be navigated to from the sidebar, like the following: