Skip to content

Commit 1d22cfb

Browse files
chore: edit readme
1 parent 19851b0 commit 1d22cfb

File tree

2 files changed

+42
-17
lines changed

2 files changed

+42
-17
lines changed

README.md

Lines changed: 41 additions & 16 deletions
Original file line numberDiff line numberDiff line change
@@ -25,6 +25,8 @@
2525

2626
---
2727

28+
> 💬 Este repositorio cuenta con una configuración base para **GitHub Actions**, **Codecov** y **SonarCloud**, las cuales se pueden remover fácilmente del proyecto o bien, terminar de configurarlas para aprovechar al maximo las buenas prácticas.
29+
2830
<a name="basic-requirements"></a>
2931

3032
## 📝 Requerimientos básicos
@@ -37,7 +39,8 @@
3739

3840
## 🙌 Let's start
3941

40-
Con el botón **Use this template**, creamos un repositorio nuevo en nuestro **GitHub** copiando todos los archivos del repositorio original, y luego hacemos un `git clone` del mismo.
42+
Con el botón **Use this template**, creamos un repositorio nuevo en nuestro **GitHub** copiando todos los archivos del
43+
repositorio original, y luego hacemos un `git clone` del mismo.
4144

4245
También podés ejecutar el siguiente script cambiando el nombre de destino
4346

@@ -46,18 +49,22 @@ git clone https://github.com/rudemex/nestjs-package-starter.git <nombre-de-desti
4649
```
4750

4851
Example:
52+
4953
```bash
5054
git clone https://github.com/rudemex/nestjs-package-starter.git my-awesome-package
5155
```
5256

53-
Una vez clonado el repositorio, tenemos que cambiar el `name` del archivo `package.json`, ya que este va a ser el nombre del paquete a generar.
57+
Una vez clonado el repositorio, tenemos que cambiar el `name` del archivo `package.json`, ya que este va a ser el nombre
58+
del paquete a generar.
5459

5560
```json
5661
{
5762
...,
58-
- "name": "nestjs-package-starter",
59-
...
60-
+ "name": "my-awesome-package",
63+
-
64+
"name": "nestjs-package-starter",
65+
...
66+
+
67+
"name": "my-awesome-package",
6168
...
6269
}
6370
```
@@ -78,39 +85,57 @@ Estando en la carpeta del proyecto, instalamos sus dependencias con el script.
7885

7986
## 💻 Scripts
8087

88+
### Inicia los test con coverage
89+
90+
```
91+
npm run test
92+
```
93+
94+
### Eslintea el código
95+
96+
```
97+
npm run lint
98+
```
99+
81100
### Realiza el build del paquete
82101

83102
```
84103
npm run build
85104
```
86105

87-
Los builds se hacen con una herramienta llamada `@pika/pack` que por debajo usa `rollup`, una vez que el build se realizó, vas a poder acceder al contenido generado entrando a:
106+
Los builds se hacen con una herramienta llamada `@pika/pack` que por debajo usa `rollup`, una vez que el build se
107+
realizó, vas a poder acceder al contenido generado entrando a:
88108

89109
```bash
90110
cd ./pkg
91111
```
92112

93-
El folder `pkg` va a contener todo lo que necesitamos, desde los diferentes builds, hasta el `package.json` con las referencias a los módulos generados.
94-
95-
Para probar localmente el paquete antes de publicarlo, podés utilizar el comando `npm link` estando dentro de la carpete `./pkg`, y luego instalarlo en tu proyecto para probarlo.
113+
El folder `pkg` va a contener todo lo que necesitamos, desde los diferentes builds, hasta el `package.json` con las
114+
referencias a los módulos generados.
96115

97-
### Inicia los test con coverage
116+
Para probar localmente el paquete antes de publicarlo, podés utilizar el comando `npm link` estando dentro de la
117+
carpeta `./pkg`, y luego instalarlo en tu proyecto para
118+
probarlo. [más info](https://medium.com/@AidThompsin/how-to-npm-link-to-a-local-version-of-your-dependency-84e82126667a)
98119

99-
```
100-
npm run test
101-
```
120+
### Publicar el paquete
102121

103-
### Eslintea el código
122+
Para publicar el paquete, podés configurar el `@pika/publish`, o bien podés ejecutar alguno de los siguientes scripts
123+
una vez dentro de la carpeta `./pkg` previamente generada.
104124

125+
```bash
126+
npm publush
105127
```
106-
npm run lint
128+
129+
```bash
130+
yarn publush
107131
```
108132

109133
<a name="commits"></a>
110134

111135
## 📤 Commits
112136

113-
Para los mensajes de commits se toma como referencia [`conventional commits`](https://www.conventionalcommits.org/en/v1.0.0-beta.4/#summary).
137+
Para los mensajes de commits se toma como
138+
referencia [`conventional commits`](https://www.conventionalcommits.org/en/v1.0.0-beta.4/#summary).
114139

115140
```
116141
<type>[optional scope]: <description>

package.json

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
{
22
"name": "nestjs-package-starter",
3-
"version": "0.0.1",
3+
"version": "1.0.0",
44
"description": "NestJS npm package starter",
55
"author": {
66
"name": "Maximiliano \"Mex\" Delgado",

0 commit comments

Comments
 (0)