How to Use Page UI Components in Your React or Next.js Project
Updated
Page UI is a copy-and-paste component library for React and Next.js landing pages, built on Shadcn UI and TailwindCSS. You use it by copying a component or template section from the docs or templates gallery and pasting it directly into your own codebase, where the code becomes yours to modify. This works best if your project already uses TailwindCSS and the Shadcn UI conventions, since Page UI components are built on top of them.
What you need before copying
Page UI is not installed as a package you import from. The workflow is copy-and-paste, so the main prerequisite is a project that can render the pasted code correctly.
- React or Next.js project — Page UI is made for React and built on TailwindCSS.
- TailwindCSS configured — the components rely on Tailwind utility classes for styling.
- Shadcn UI setup — Page UI is built on top of Shadcn UI, so components assume the same primitives and conventions are available in your project.
- A target location — decide where the pasted section will live, such as a page file or a components folder.
If your project does not yet use Shadcn UI or TailwindCSS, set those up first. Otherwise pasted components may render without their expected styles or dependencies.
Step-by-step: from Page UI to your codebase
1. Open the docs or templates gallery
Go to the Page UI docs or the templates section. The docs contain hundreds of examples you can copy and modify, and templates are organized by use case — for example, Gnomie AI for a B2C AI SaaS app, Specta for a creator platform, and Minimum Via for a minimal product or productized agency.
2. Pick a component or a full section
You can start from a single component or copy an entire template section. The site describes this as "landing pages on easy mode" — copy any section of a template and own it forever in your codebase. There is also a "thief mode" that lets you copy any section with a click.
3. Copy the code
Use the copy action in the docs or template. The docs include props and code samples for each component, so you can see what the component expects before you paste it.
4. Paste into your React/Next.js project
Paste the copied code into the file where you want the section to appear. Because the code is now in your codebase, you can edit it freely — change text, colors, layout, or logic.
5. Verify it renders
Run your project and check the section in the browser. Expected result: the section renders with Tailwind styles and Shadcn UI primitives intact. If it looks unstyled or throws missing-import errors, the usual cause is that TailwindCSS or Shadcn UI is not fully configured in your project.
6. Adjust and ship
Once it renders, modify the copy and layout to match your product. Page UI's stated goal is to help you ship a landing page quickly, so the final step is replacing placeholder content with your own.
Common sticking points
- Missing Shadcn UI primitives — components built on Shadcn UI may reference primitives your project has not added yet. Add the missing ones rather than rewriting the component.
- Tailwind not picking up classes — if your Tailwind content paths do not include the folder where you pasted the component, styles may be purged. Check your Tailwind config.
- Treating it like an npm package — Page UI is copy-and-paste, not an import. There is no install step that brings components in automatically.
- Theme mismatch — the docs let you switch between themes, so a component may look different in your app than in the docs if your theme tokens differ.
What you get and what to check
| Aspect | Detail |
|---|---|
| Integration method | Copy and paste into your React/Next.js codebase |
| Built on | Shadcn UI and TailwindCSS |
| Ownership | Copied code belongs to you and can be modified freely |
| Docs | In-depth docs with props and code samples per component |
| Templates | Multiple templates by use case, with new ones added over time |
| Licensing | Described as free and open source |
Page UI also mentions an AI tool, Page AI, that builds production-ready websites using Page UI, which you can try if you want a generated starting point instead of copying sections manually.
If your project already runs TailwindCSS and Shadcn UI, the fastest path is: open a template, copy the section you want, paste it into your page, and adjust. If it does not, set up those two first — that is the step most likely to determine whether the pasted components work on the first try.