Forem: Riina Korpela

Different approaches to testing your own packages locally: npm yalc

Riina Korpela — Thu, 12 Jan 2023 08:47:37 +0000

This is part of a series of articles:

Linking local files

npm link

npm yalc

Verdaccio

Relative deps

In this article we'll be looking at npm yalc, and how it can be used to test your packages with examples based on the next structure.

Also, we will talk about why to choose yalc instead of npm link.

npm yalc

Yalc acts as simple local repository to share your local developed packages in your local environment. When you publish a package with yalc, the files that should be published to NPM are stored in a special global store.

Then if you add the package in another project, this project will pull the package content from this special global store, and injects a file:/link: dependency into package.json, and creates a local yalc.lock file to ensure consistency in the internal routines.

The usage of yalc is quite simple following next steps:

You need to install yalc globally on your machine:
```
  npm i yalc -g
```
You need to publish your fancy dependency library:
```
  cd my-fancy-library 
  yalc publish
```
This will copy all the files that should be published in a remote NPM registry. This means if your package has some lifecycle scripts, they will run with the publish.

To avoid the scripts, run:
```
  cd my-fancy-library 
  yalc publish --no-scripts
```
To add this new locally published package to your awesome project:
```
  cd my-awesome-project 
  yalc add @ks/my-fancy-library  
```
To update the dependency library, you can do it with an update:
```
  yalc update @ks/my-fancy-library 
```
But if you have the same dependency on several dependent packages, you can push the changes to all of them in one command:
```
  yalc publish --push  
```
To finally remove the dependency from yalc in the dependent project:
```
  yalc remove @ks/my-fancy-library 
```
or you can use --all flag to remove all the yalc packages from the project.
You can unpublish the library published on the second step with:
```
  yalc installations clean @ks/my-fancy-library 
```

Use yalc instead of npm link

You might be wondering, why I use yalc instead of the npm link if they are very similar. I will give you some context about my projects first.

In my actual project, we have several UI-component libraries depending on others, working a little bit as a micro-frontend would work, but with more pyramidal hierarchy. They are typescript projects with storybook, babel, jest for testing... All of them are shared between several teams, with different node versions.

When the npm link is used, the project’s specific version of node will be used to create the link, and only the projects using the same version will be able to access the local version. Npm link doesn’t throw any errors when this happens.

Some of our projects have references to peerDependencies, and it’s very easy to stumble into issues with symlinks, as the projects' peerDependencies are not always resolved when needed.

Also, there are some documented errors like duplicated react when using npm link.

All of these issues are relatively easy to fix, but after running into them several times, we started to use yalc, and since then, there have not been any similar issues.

I hope you find this useful, please leave a comment in case of any question or feedback.

My experience with ADHD and remote work

Riina Korpela — Mon, 22 Nov 2021 11:32:33 +0000

I got my very first remote job in the middle of the global pandemic. I finished my maternity leave after having my baby, and I had to start working with a five-month-old baby, with all the nurseries in Spain closed. Furthermore, I had a great opportunity to grow as a developer, and I had to take advantage of it, but the first days working from home and taking care of my "intensita" were a scary experience.

I have always thought that I am not disciplined enough to keep focus by myself, maybe I have always had a little bit of impostor syndrome. I know I am not lazy, but I have always struggled to keep focus. Once I started to get used to remote working, I started to compare myself with my teammates and I always had the feeling that I wasn’t able to do the same things. My teammates were able to be in a meeting for hours, or finish the work very fast, and some minor tasks could take me hours to finish.

Something was wrong. I love my work, and usually I don’t have this kind of problem. I started to be more demotivated with my work, and my personal life wasn’t going great either. I decided to look for some professional help, and that is how I got diagnosed with ADHD.

Having a baby limited my own and professional time, making every second more important, so I had to make more decisions than ever. These decisions and the stress with the pandemic were too much for me to handle, and even though I have always had ADHD, my symptoms got much worse.
But that diagnosis made me very happy indeed. Finally, I had a name for a lot of the things that were going on in my brain but nobody understood.

The only hobby that I have always loved is software development. I think it is because every programmer knows that we do things, we learn by executing new tasks, and we never stop learning and being active. We don’t get bored!
But even with my passion for new technologies, I needed some time to organize myself and my brain to be able to work well by myself, so I want to share some of my tricks to make my days better and more focused.

Do not mask!

My first advice is "do not mask". If you have to mask while you are in your own home, you won't ever be comfortable and secure working in your environment. If you hide it doesn’t go away.

People with neurodiversity try to present themselves as neurotypical people and follow the rules of the neurotypical world. For example, we buy a cool ergonomic chair or standing desk like we see our teammates do, but that doesn’t always work for us. We have to accept that our brain doesn't work the same way as most people's brains, and it’s going to be there forever, and we have to listen to our body.

Many times, I have found myself working on the floor, just sitting with my laptop on my knees, or in not ergonomic postures in my expensive ergonomic chair. So now I bought a small coffee table to place my laptop and I do my meetings sitting on the floor. At my work desk, I don’t have anything but my headphones and my iPad. I use my iPad in the meeting to take notes to avoid interruptions (ADHD people can have the urgency to interrupt to not forget what we are thinking), and music is my favorite tool to program to. Music helps me to get in the flow of code and a good mood, so it allows me to concentrate more on my work.

I have tried to use a Pomodoro timer, and I have tried many focus applications, but they don’t work for me, but every person is different, so it may work for you. Usually, I reserve some time in "Do not disturb" mode, especially after the daily/weekly meetings. I installed a Quitter app that allows me to set up rules to close my apps when they've been inactive for a while. What worked for me too to avoid the anxiety of having the apps open was to delete the open tick for the apps in the mac’s dock.

Focus on now.

To me, it’s important to organize the day with priorities and focus first on the things I can do now. I prefer to send that pending email to my boss before starting to code or clean all the old tickets on the Github board before picking my next task.

I have realized that my procrastination is very productive, but not for work. Maybe I am cleaning my desk, forgetting about that very important meeting. That is why the shared notifications between my mac, my iPad, and my mobile are the key to being able to remember all the meetings and all the pending tasks.

My first hour before my daily meetings, I spend with easy, minor tasks, so the rest of the day I can focus on my actual coding tasks. That allows me to reduce the anxiety and closing tasks is always a good start for a new day!

It’s okay to ask for help

I work with an awesome team. They love coding, learning new things and most of them participate actively in open source projects, or they have several side projects. Some of them write on blogs or are content creators on platforms like Youtube or Twitch.

I am not that kind of person, I have never been. I love my work, but it’s only work, and since my baby is here, I don’t spend time outside of my 8 daily hours of work to code or read articles about the new features of the technologies we work on.

That is why I have learned that it is okay to ask for help, being surrounded by such awesome coders and not learning from them is such a waste of time! Asking them even “silly questions” makes me a better developer, and that is to me the definition of success.

In my team, we have several ways of communication to allow us to have fluid conversations. Sometimes it is hard to maintain relationships, especially when we all are remote workers, so we try to connect. We have a lot of pair-programming sessions, we spend time debating the best solutions, and that makes us a better team, and makes our code much better quality. And the most important thing to remember is that you work in a team, everybody makes mistakes and we must learn to accept criticism.