Mis herramientas del día a día
En este proyecto están las herramientas que uso y aprovecho para probar:
- pnpm
- los monorepos con los workspace de npm
- torborepo de Vercel
Instalación
Usa la versión de Node.js de .node-version y la versión de pnpm de packageManager en package.json. Luego clona el proyecto.
git clone git@github.com:diazdavid-info/my-tools.git
Instalar las dependencias
pnpm i
Qué hay dentro del este proyecto
- packages
- eslint-config-mytools -> mi configuración de eslint y pritter que será compartida para todas las herramientas del monorepo
- mytools-tsconfig -> mi configuraciones de typescript que será compartida para todas las herramientas del monorepo
- mytools-components -> un listado de componentes que estarán disponibles para posibles proyectos de front alojados en este monorepo
Cómo inicializar nueva app o nuevo package
- Crea un directorio dentro de
/appso de/packages - Inicializa pnpm
pnpm init - Instala ts y eslint
pnpm i -D @mytools/tsconfig eslint-config-mytools - Copia los ficheros
.eslintrc.jsytsconfig.jsonde cualquiera otra app
Desplegar apps y publicar nuevas versiones
- Ejecuta
pnpm buildypnpm testantes de abrir el PR. Ejecutapnpm changesetpara elegir los proyectos que van a subir de versión y el tipo de cambio (patch,minoromajor). Incluye el changeset en el mismo PR. - Fusiona el PR del cambio en
main. GitHub Actions verifica las dependencias, compila el repo y ejecuta las pruebas. - Comprueba el despliegue de la app en su plataforma.
task-generatorusa Vercel ytypinggenera un sitio estático enapps/typing/dist/. - En Cloudflare Pages, configura
monaco-editorconmaincomo rama de producción, la raíz del repo como directorio de trabajo,PNPM_VERSION=11.21.0, el comandopnpm --filter monaco-editor buildy la salidaapps/monaco-editor/dist. Pages lee la versión de Node de.node-version. Entorno de compilación de Cloudflare Pages. - Para
split-countysearch-home, construye la imagen desde la raíz con el Dockerfile de la app, por ejemplodocker build -f apps/split-count/Dockerfile .. En el despliegue, monta un volumen persistente y apuntaDB_PATHa un fichero SQLite dentro del volumen. - Si hay changesets pendientes en
main, GitHub Actions crea o actualiza el PR de versiones desdechangeset-release/main. Revisa las versiones y los changelogs. Si GitHub lo pide, pulsa Approve workflows to run para ejecutar los checks del PR. - Fusiona el PR de versiones cuando pasen los checks. Tras validar
main, GitHub Actions publica con procedencia las versiones pendientes de los paquetes autorizados que ya existen en npm. Changesets también registra versiones y changelogs de las apps privadas. Lista de paquetes autorizados. - Confirma en GitHub Actions que pasó el job
publishy verifica en npm la nueva versión, su etiquetalatesty su procedencia.
Activar la publicación automática
- En GitHub, habilita Allow GitHub Actions to create and approve pull requests bajo Settings → Actions → General.
- En npm, configura un Trusted Publisher para cada paquete antes de su primera publicación automática. Selecciona GitHub Actions, el propietario
diazdavid-info, el repositoriomy-toolsy el workflowgithub-actions.yml. Deja el entorno vacío y habilitanpm publish. La primera publicación debe completarse dentro de los dos días siguientes a la configuración. Documentación de npm.
CI ejecuta npm audit signatures para verificar las firmas del registro y las atestaciones de procedencia disponibles antes de ejecutar los scripts de instalación de las dependencias.