Skip to main content

Tutorial Intro

Time to get the ball rolling and start shipping everything under the web app sun in a single one repo.

Do you want to get started bulding with a turborepo powered typescripe monorepo project setup with linting, tests, code formatting, github actions, vscode, nextjs, trpc, msw, docusaurus, and more!

Whats included​

apps/

  • trpc-api: a tRPC server app (backend server agnostic, but currently runs in main-app nextjs server)
  • main-app: a Next.js app
    • msw/msw-trpc configured for testing
    • fly.toml: fly.io configuration
  • doc-site: a docusaurus markdown based documenation website

packages/

  • auth: a placeholder package to handle auth. no real logic here for now.
  • logger: isomorphic logger (a small wrapper around console.log) no real logic here for now.
  • ui: a dummy React UI library (which contains a single <CounterButton> component)
  • eslint-config-custom: ESLint configurations
  • jest-presets: Jest configurations
  • tsconfig: tsconfig.json's used throughout the monorepo

.vscode/

  • extensions.json: a list of recommended vscode extensions
  • settings.json: a list of recommended vscode settings

pnpm-workspace.yaml: pnpm workspace configuration

docker-compose.yaml: docker compose configuration

prettier.config.js: prettier configuration

render.yaml: render.com configuration

Getting Started​

Clone the repo, and get your project started!

What you'll need​

  • Node.js version 18 or above:
    • When installing Node.js, you are recommended to check all checkboxes related to dependencies.
  • pnmp version 8 or above

Generate a new site​

clone the project:

git clone https://github.com/estepanov/my-turbo-stack.git my-custom-turbo-stack

open the project directory:

cd my-custom-turbo-stack

Install all dependencies

pnpm i

Start your site​

Run the development server:

pnpm dev

This boots all the apps into dev mode.

If you want to boot a specifc app, such as the docusaurus app in apps/doc-site, then you can filter by app name:

pnpm dev --filter doc-site

or if you just want to boot the nextjs app in apps/main-site you can run

pnpm dev --filter main-app