rsnext/examples/with-patternfly/README.md
JTaylor0196 f7baa56792
update example Deploy button URLs (#48842)
### What?
Updates Deploy button URLs for all listed examples here:
https://github.com/vercel/next.js/tree/canary/examples

### Why?
The Deploy URLs are currently broken and result in a failed clone
attempt on Vercel.

### How?
The URLs have been changed from https://vercel.com/new/git/external?… to
-> https://vercel.com/new/clone?…
(Last updated
[here](8eaabe2fb0)
in 2021)
2023-04-26 13:31:44 -04:00

2.7 KiB

PatternFly 4 example

This example shows how to use Next.js with the PatternFly 4 design system.

Deploy your own

Deploy the example using Vercel or preview live with StackBlitz

Deploy with Vercel

How to use

Execute create-next-app with npm, Yarn, or pnpm to bootstrap the example:

npx create-next-app --example with-patternfly with-patternfly-app
yarn create next-app --example with-patternfly with-patternfly-app
pnpm create next-app --example with-patternfly with-patternfly-app

Deploy it to the cloud with Vercel (Documentation).

Troubleshooting

Global CSS cannot be imported from within node_modules

PatternFly 4 packages published on npm use Global CSS imports for styling of React components, which is not supported by Next.js. To workaround this issue, this example uses next-transpile-modules to transpile the packages during compilation. As a consequence, all packages that depend on @patternfly/react-styles need to be transpiled as well.

If you receive this error, verify whether all packages that depend on @patternfly/react-styles are specified in next.config.js.

PatternFly components do not appear to be styled

If your Next.js application compiles successfully, but PatternFly components in your application do not appear to be styled, make sure you have applied the global PatternFly stylesheet in pages/_app.js:

// In pages/_app.js
import App from 'next/app'
import '@patternfly/react-core/dist/styles/base.css'

...

All components styles are imported when using a PatternFly component

This is expected behavior in development mode. Tree shaking will remove these imports in production builds.