Proyecto base para desarrollo full-stack con Angular 20 + NestJS + MongoDB
Un starter template moderno y completo que incluye autenticación, temas automáticos, internacionalización y arquitectura escalable.
- ✅ Angular 20 con componentes standalone
- ✅ PrimeNG para UI/UX profesional
- ✅ Tailwind CSS para layouts y spacing
- ✅ Tema automático que detecta preferencias del sistema
- ✅ Internacionalización (i18n) con Transloco
- ✅ Autenticación JWT con Google OAuth
- ✅ Arquitectura Repository-Service-Pages
- ✅ Responsive design y animaciones modernas
- ✅ TypeScript strict mode
- ✅ NestJS con TypeScript
- ✅ MongoDB con Mongoose
- ✅ Autenticación JWT + Google OAuth
- ✅ Guards y Interceptors
- ✅ Validación con DTOs
- ✅ Manejo global de errores
- ✅ Configuración por ambientes
Antes de comenzar, asegúrate de tener instalado:
- Node.js (v18 o superior)
- npm (v9 o superior)
- MongoDB (local o en la nube)
- Git
git clone <tu-repositorio>
cd project-base-ng-nest# Navegar al directorio del backend
cd back-app
# Instalar dependencias
npm install
# Configurar la aplicación editando el archivo de configuración
# Edita: src/config/config.tsConfigurar la aplicación en back-app/src/config/config.ts:
export default () => {
return {
port: 3000,
database: {
uri: "mongodb://localhost:27017/project-base-dev",
},
jwt: {
secret: "your-super-secret-jwt-key-change-in-production",
expiresIn: "1h",
refreshExpiresIn: "7d",
},
google: {
clientId: "your-google-client-id",
clientSecret: "your-google-client-secret",
},
cors: {
origin: "http://localhost:4200",
},
};
};Para MongoDB Atlas (cloud), cambia la URI de la base de datos:
database: {
uri: 'mongodb+srv://usuario:password@cluster.mongodb.net/database',
},Ejecutar el backend:
# Desarrollo
npm run start:dev
# Producción
npm run build
npm run start:prod# Navegar al directorio del frontend
cd front-app
# Instalar dependencias
npm install
# Los archivos de environment ya existen, solo necesitas editarlos
# Edita: src/environments/environment.ts
# Edita: src/environments/environment.prod.tsConfigurar variables de entorno en front-app/src/environments/environment.ts:
export const environment = {
production: false,
api: {
baseUrl: "http://localhost:3000",
prefix: "/api",
},
auth: {
googleClientId: "YOUR_GOOGLE_CLIENT_ID_HERE",
},
};Para producción en front-app/src/environments/environment.prod.ts:
export const environment = {
production: true,
api: {
baseUrl: "https://your-api-domain.com",
prefix: "/api",
},
auth: {
googleClientId: "YOUR_PRODUCTION_GOOGLE_CLIENT_ID_HERE",
},
};Ejecutar el frontend:
# Desarrollo
npm start
# La aplicación estará disponible en http://localhost:4200
# Build para producción
npm run build
# Linting y formato
npm run lint
npm run formatSi quieres habilitar la autenticación con Google:
- Ve a Google Cloud Console
- Crea un nuevo proyecto o selecciona uno existente
- Habilita la Google+ API
- Ve a Credenciales → Crear credenciales → ID de cliente OAuth 2.0
- Configura los orígenes autorizados:
- Desarrollo:
http://localhost:4200 - Producción:
https://tu-dominio.com
- Desarrollo:
Agrega las credenciales obtenidas en los archivos de configuración:
Backend (back-app/src/config/config.ts):
google: {
clientId: 'tu-google-client-id-real',
clientSecret: 'tu-google-client-secret-real',
},Frontend (front-app/src/environments/environment.ts):
auth: {
googleClientId: "YOUR_GOOGLE_CLIENT_ID_HERE",
},Instalar MongoDB Community:
- Windows/macOS: Descarga desde MongoDB Official Site
- Ubuntu/Debian:
sudo apt-get install mongodb sudo systemctl start mongodb
- macOS con Homebrew:
brew install mongodb-community brew services start mongodb-community
La URL por defecto será: mongodb://localhost:27017/project-base-dev
- Crea una cuenta en MongoDB Atlas
- Crea un cluster gratuito
- Configura acceso de red (IP Whitelist)
- Crea un usuario de base de datos
- Obtén la cadena de conexión y úsala en
MONGODB_URI
project-base-ng-nest/
├── 📁 back-app/ # Backend NestJS
│ ├── src/
│ │ ├── auth/ # Módulo de autenticación
│ │ ├── users/ # Módulo de usuarios
│ │ ├── common/ # Filters, guards, interceptors
│ │ ├── config/ # Configuración
│ │ └── main.ts
│ └── package.json
│
├── 📁 front-app/ # Frontend Angular
│ ├── src/
│ │ ├── app/
│ │ │ ├── core/ # Servicios, repositorios, DTOs
│ │ │ ├── pages/ # Páginas de la aplicación
│ │ │ ├── guards/ # Guards de rutas
│ │ │ ├── models/ # Modelos de dominio
│ │ │ └── theme/ # Configuración de temas
│ │ ├── environments/ # Configuración por ambiente
│ │ └── styles/ # Estilos globales
│ ├── public/
│ │ └── i18n/ # Archivos de traducción
│ └── package.json
│
└── README.md # Este archivo
El proyecto incluye soporte completo para múltiples idiomas:
- 🇪🇸 Español (por defecto)
- 🇺🇸 Inglés
-
Crea un nuevo archivo en
front-app/public/i18n/:cp public/i18n/es.json public/i18n/fr.json
-
Traduce el contenido del archivo
-
Actualiza la configuración en
front-app/src/app/app.config.ts:availableLangs: ['en', 'es', 'fr'],
<!-- En templates -->
<h1>{{ 'LOGIN.HEADER.TITLE' | transloco }}</h1>
<!-- En TypeScript -->
this.translocoService.translate('LOGIN.HEADER.TITLE')El proyecto incluye un sistema de temas inteligente:
- 🖥️ Automático - Detecta y sigue la preferencia del sistema
- ☀️ Claro - Fuerza modo claro
- 🌙 Oscuro - Fuerza modo oscuro
Edita front-app/src/app/theme/custom-theme.ts para personalizar la paleta de colores.
npm run start:dev # Desarrollo con hot-reload
npm run start:prod # Producción
npm run build # Compilar
npm run test # Tests unitarios
npm run test:e2e # Tests end-to-end
npm run lint # Linternpm start # Desarrollo (puerto 4200)
npm run build # Build para producción
npm run test # Tests unitarios
npm run lint # Linter
npm run format # Formatear códigoEl proyecto está optimizado para todos los dispositivos:
- 📱 Mobile (320px+)
- 📊 Tablet (768px+)
- 🖥️ Desktop (1024px+)
- 🖥️ Large Desktop (1440px+)
- ✅ JWT con expiración configurable
- ✅ Refresh tokens automáticos
- ✅ Guards de autenticación en rutas
- ✅ Validación de datos con DTOs
- ✅ CORS configurado
- ✅ Sanitización de datos
- Usar HTTPS en producción
- Configurar rate limiting
- Implementar CSP headers
- Auditar dependencias regularmente:
npm audit
cd front-app
npm run test # Tests unitarios con Karma + Jasmine
npm run test:coverage # Coverage reportcd back-app
npm run test # Tests unitarios con Jest
npm run test:e2e # Tests de integración
npm run test:cov # Coverage reportnpm run build
# Subir carpeta dist/ a tu servicio de hostingnpm run build
npm run start:prodNo olvides actualizar el archivo back-app/src/config/config.ts con los valores de producción antes de hacer el deployment.
- Fork el proyecto
- Crea una rama para tu feature (
git checkout -b feature/nueva-funcionalidad) - Commit tus cambios (
git commit -m 'Agregar nueva funcionalidad') - Push a la rama (
git push origin feature/nueva-funcionalidad) - Abre un Pull Request
Este proyecto está bajo la licencia MIT. Ver el archivo LICENSE para más detalles.
Borja Sahuquillo Ferrer
- GitHub: @BorjaSahuquillo
¡Feliz coding! 🚀