Next.js installation

Start by creating your Next.js project if you don't have one already. Using Create Next App should speed up this process:

npx create-next-app@latest my-reshaped-app --experimental-app
cd my-reshaped-app

Or if you're using Typescript:

npx create-next-app@latest my-reshaped-app --typescript --experimental-app
cd my-reshaped-app

Note that we're using an --experimental-app flag to use the new app directory introduced in Next 13. Using this directory adds support for global css import within node_modules, which lets Reshaped work with Next.js out-of-the-box.

Download the latest Reshaped release from the Releases page and save the .tgz file into your project. Then install the package using the file path. For example, if you save the package as ./vendor/reshaped.tgz in the project root folder, you can run:

// npm
npm install ./vendor/reshaped.tgz

// yarn
yarn add ./vendor/reshaped.tgz

Import PostCSS config from Reshaped and add it to postcss.config.js file in the root folder:

const postcss = require("reshaped/postcss");
module.exports = postcss.config;

Run your build process with npm run dev.

npm run dev

Import components in app/page.tsx and try them out:

import { Button, Container, Reshaped } from "reshaped";
import "reshaped/themes/reshaped/theme.css";

const App = () => {
  return (
    <Reshaped theme="reshaped">
      <Container width="652px">
        <Button href="/">Get started</Button>
      </Container>
    </Reshaped>
  );
};

You can find more details in our next-13-starter example on Github. If you want to learn more about components - search for the relevant components documentation in the sidebar.