Clonar los repos

El stack vive en varios repos hermanos. Las herramientas (sobre todo el dev-stack que levanta todo a la vez) asumen que están clonados al lado unos de otros bajo el mismo directorio padre.

Estructura recomendada (lo mínimo para empezar)

Para correr el stack web completo en local solo necesitas tres repos:

~/workspace/mseller/
├── mseller-api/        # Backend .NET (Portal, Ingestion, Consumo)
├── mseller-firebase/   # Cloud Functions + emuladores Firebase
└── mseller-cloud/      # UI Next.js

El nombre del directorio padre (mseller) no importa, pero los nombres de los subdirectorios sí — los scripts de bootstrap los buscan literalmente.

Comandos

mkdir -p ~/workspace/mseller && cd ~/workspace/mseller

git clone git@github.com:victors1681/mseller-api.git
git clone git@github.com:victors1681/mseller-firebase.git
git clone git@github.com:victors1681/mseller-cloud.git

Cuando los repos se transfieran a la organización MSeller, el comando cambia a git clone git@github.com:MSeller/<repo>.git. GitHub redirige las URLs viejas, así que tu clone existente sigue funcionando sin cambios.

Repos opcionales (clónalos cuando los necesites)

No los clones en tu primer día — añádelos solo cuando vayas a tocarlos.

~/workspace/mseller/
├── mseller-docs/             # Esta documentación (la estás leyendo online)
├── mseller-marketing-site/   # Landing público — mseller.app
├── mobile-seller/            # iOS app nativa para vendedores en campo (Swift)
├── mobile-seller-auth-v3/    # UI legacy de admin de Firebase Auth (mantenimiento)
├── mseller-lite/             # App de almacén (Expo/React Native, picking + carga)
└── mseller-infrastructure/   # IaC (Terraform/Bicep) — solo para DevOps

Repo	Cuándo clonarlo
`mseller-docs`	Si vas a contribuir a esta documentación. Para solo leerla, abre el sitio web.
`mseller-marketing-site`	Si vas a editar el landing público (`mseller.app`).
`mobile-seller`	Si trabajas en la app iOS de vendedores. Necesitas macOS + Xcode.
`mobile-seller-auth-v3`	Casi nunca — está en modo mantenimiento. Solo si te asignan un fix.
`mseller-lite`	Si trabajas en el flujo de almacén (preparación de pedidos / carga de camión).
`mseller-infrastructure`	Si trabajas en deploy, secretos, o configuración de cloud.

Comandos cuando los necesites:

cd ~/workspace/mseller
git clone git@github.com:victors1681/mseller-docs.git
git clone git@github.com:victors1681/mobile-seller.git
git clone git@github.com:victors1681/mseller-lite.git
# ... etc

¿No tienes acceso SSH a GitHub?

Si nunca has configurado una llave SSH, sigue la guía de GitHub o, como alternativa rápida, usa HTTPS:

git clone https://github.com/victors1681/mseller-api.git
# ... etc

Con HTTPS te va a pedir tu usuario y un personal access token cada vez que hagas push. Para algo permanente, configura SSH (toma 5 minutos).

¿Qué traen los repos?

Cada repo trae un README.md y un CONTRIBUTING.md con detalles específicos. Lo más importante a primera vista:

Repo	Archivo a leer primero
mseller-api	`README.md` y `dev-stack/README.md`
mseller-firebase	`README.md` y `docs/EMULATORS.md`
mseller-cloud	`README.md` y `CLAUDE.md`
mseller-docs	Este sitio

Próximo paso

Instalar dependencias →