This is a portfolio monorepo for professionals.
This Turborepo includes the following packages/apps:
@repo/*
: Next.js apps with Tailwind CSS@repo/ui
: a React component library with Tailwind CSS shared by bothweb
anddocs
applications@repo/eslint-config
:eslint
configurations (includeseslint-config-next
andeslint-config-prettier
)@repo/tailwind-config
:tailwind
configs used throughout the monorepo@repo/typescript-config
:tsconfig.json
s used throughout the monorepo
Each package/app is 100% TypeScript.
-
pnpm install
install & init dependencies -
pnpm dev
run dev commands in all modules -
pnpm build
build artifacts (used for deployment really) -
Open http://localhost:3000 with your browser to see the result.
-
You can start editing the page by modifying
apps/web/app/page.tsx
. The page auto-updates as you edit the file. -
This project uses
next/font
to automatically optimize and load Inter, a custom Google Font.
This example is set up to produce compiled styles for ui
components into the dist
directory. The component .tsx
files are consumed by the Next.js apps directly using transpilePackages
in next.config.js
. This was chosen for several reasons:
- Make sharing one
tailwind.config.js
to apps and packages as easy as possible. - Make package compilation simple by only depending on the Next.js Compiler and
tailwindcss
. - Ensure Tailwind classes do not overwrite each other. The
ui
package uses aui-
prefix for it's classes. - Maintain clear package export boundaries.
Another option is to consume packages/ui
directly from source without building. If using this option, you will need to update the tailwind.config.js
in your apps to be aware of your package locations, so it can find all usages of the tailwindcss
class names for CSS compilation.
For example, in tailwind.config.js:
content: [
// app content
`src/**/*.{js,ts,jsx,tsx}`,
// include packages if not transpiling
"../../packages/ui/*.{js,ts,jsx,tsx}",
],
If you choose this strategy, you can remove the tailwindcss
and autoprefixer
dependencies from the ui
package.
This Turborepo has some additional tools already setup for you:
- Tailwind CSS for styles
- TypeScript for static type checking
- ESLint for code linting
- Prettier for code formatting