How to migrate your single-repo to a monorepo

Victor Oliveira — Mon, 04 Dec 2023 12:20:22 +0000

I recently realized the need to migrate the projects I was working on to a monorepo and documented the process, so in this post I will teach you what a monorepo is and how to migrate your single repo next projects to a monorepo using turborepo as and share its components between them.

1. What is a Monorepo?

in a simple way monorepo is a single repository containing multiple distinct projects, with well defined relationships, understand more about monorepos here.

2. What problem does it solve?

My problem was that there were many projects that need the same components and configurations between them, so I joined Turborepo to facilitate maintenance.

3. How to migrate?

Come on, to start the migration you need to install turbo globally in your project

npm install turbo --global

Next we need to add a file called turbo.json containing the following information to the root of your project.

{
  "$schema": "https://turbo.build/schema.json",
  "globalDependencies": ["**/.env.*local"],
  "pipeline": {
    "build": {
      "dependsOn": ["^build"],
      "outputs": [".next/**", "!.next/cache/**"]
    },
    "deploy": {
      "dependsOn": ["build", "test", "lint"]
  },
    "dev": {
      "cache": false,
      "persistent": true
    }
  }
}

If after this you can run turbo build everything went perfect.

Now let's configure the workspaces.

Turbo is built on top of Workspaces, a way of managing multiple packages from within a single monorepo package.

the name you give in package.json is the name of your workspace.

he default structure is add this to root's package.json.

{
  "workspaces": ["packages/*", "apps/*"]
}

And create 2 folders in the project root, one called packages and the other apps.

In the apps folder will be where your next projects are located and in the packages your libraries that will be shared.

Then move your complete next project to the apps folder.

And adds a new package.json that will be related to this. project

The structure should look something like this.

At this point you can add several projects to the apps folder.

Now let's create the first shared package.

For this we will add a folder called ui inside the packages folder.

And we will add 3 files, the first of which is the package.json referring to our ui package.

Containing the following information

{
  "name": "my-lib", 
  "main": "./index.ts",
  "dependencies": {
    "react": "^18",
  },
}

Name will be the name of your package and main refers to the entrypoint of your package.

The second file we will create will be our component

we will add called Button.tsx

import React from "react";


export default function Button() {
  return <div>Chad Button</div>
}

And the last one is index.ts in which our package.json references, containing the export of our button.

export * from './Button'

Now we need to install the package in the projects we want, so let's add my-lib by passing * the dependencies of the projects we want to use

"name": "admin",
  "version": "1.0.0",
  "private": true,
  "scripts": {
    "dev": "next dev",
    "build": "next build",
    "start": "next start"
  },
  "dependencies": {
    "my-lib": "*",
    "next": "^14.0.2",
    "react": "^18.2.0",
    "react-dom": "^18.2.0"
  },

If you are using next 13 + you will need to add this to next.config.js

/** @type {import('next').NextConfig} */
const nextConfig = {
  transpilePackages: ['my-lib'],
};

module.exports = nextConfig;

After that, just run npm install and run turbo dev!

Click here for the repository to ask questions, and if you have any problems, you can contact me on LinkedIn by clicking here.

I will see you in the next one,

Victor

How to become a better developer?

Victor Oliveira — Thu, 16 Nov 2023 16:17:15 +0000

This article will discuss what I learned from Sibelius' mentorship, and how it can help you become a better developer. To begin with, I have to talk a little about my situation and what made me turn to mentoring. I was feeling stuck and feeling the need to evolve and learn new things faster and I decided to start documenting the process through articles.

There are some points that we can follow to improve ourselves and not stop evolving, including having a winning mindset, learning in public, find a mentor and just do it.

1. Winning mindset

Most people are used to everything going right, and they can't deal when everything goes wrong, and that's where the winning mindset comes in. Being stagnant and not being able to do new things is normal, but the way we deal with it when this happens changes everything.

Looking at the problem as a whole can seem daunting so always break the problem into such small problems until it becomes impossible not to solve, no matter how challenging the problem is never give up, most people don't even try.

2. Learning in public

Learning in public will open doors, whatever your objective, do what you wish you had found when you were learning, teaching something is the most effective way to consolidate knowledge.

Show what you are doing, studying, there will certainly be other people doing the same as you or trying to learn what you are learning, don't judge your results by “applause”, retweets, or stars, just do it for yourself, something that your me from the past would like to learn.

Learning in public is more beneficial when you make mistakes, we are raised with the mentality that we cannot make mistakes, and when we make mistakes we learn the most, so stop being afraid of making mistakes, and just keep trying.

3. Find a mentor

Having a mentor can greatly accelerate your evolution, being the worst developer at the table is important to learn the most from people more experienced than you, this can help you cut corners and avoid mistakes that have already been made by other people, just by having a mentor , someone to show you the way and guide you, okay, but how do you find a mentor? Our area is extremely rich in people willing to help, so ask for help!

4. Just do it

Just start doing, the more you do the more you will evolve, the more you seek the more you will learn new things, the more you make mistakes the more you will learn, we live in a world hostage to cheap dopamine where people want everything immediately and are not willing to go through the process and pay the price, you only evolve by doing more, "you only take on more weight by taking more weight", feeling uncomfortable is part of the process, so JUST DO IT, it won't be easy but if you do a little every day, it will become easier.

The word we have to take is constancy, always focus on the long term!!