Skip to content

About

Starter de Angular 20 y Nest.js con Mongodb con Auth - SSO en Google para iniciar un proyecto en cuestión de minutos.

Resources

Stars

1 star

Watchers

0 watching

Forks

Latest commit

 

History

3 Commits

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 
 
 
 
 
 
 

Repository files navigation

🚀 Project Base Angular + NestJS

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.

✨ Características

🎨 Frontend (Angular 20)

  • ✅ 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

🛡️ Backend (NestJS)

  • ✅ 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

🛠️ Instalación y Configuración

📋 Prerequisitos

Antes de comenzar, asegúrate de tener instalado:

  • Node.js (v18 o superior)
  • npm (v9 o superior)
  • MongoDB (local o en la nube)
  • Git

🔧 Configuración del Proyecto

1. Clonar el repositorio

git clone <tu-repositorio>
cd project-base-ng-nest

2. Configurar el Backend

# 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.ts

Configurar 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

3. Configurar el Frontend

# 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.ts

Configurar 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 format

🌐 Google OAuth (Opcional)

Si quieres habilitar la autenticación con Google:

1. Configurar Google Cloud Console

  1. Ve a Google Cloud Console
  2. Crea un nuevo proyecto o selecciona uno existente
  3. Habilita la Google+ API
  4. Ve a Credenciales → Crear credenciales → ID de cliente OAuth 2.0
  5. Configura los orígenes autorizados:
    • Desarrollo: http://localhost:4200
    • Producción: https://tu-dominio.com

2. Configurar las variables

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",
},

🗄️ Base de Datos

Opción 1: MongoDB Local (Recomendado para desarrollo)

Instalar MongoDB Community:

  1. Windows/macOS: Descarga desde MongoDB Official Site
  2. Ubuntu/Debian:
    sudo apt-get install mongodb
    sudo systemctl start mongodb
  3. macOS con Homebrew:
    brew install mongodb-community
    brew services start mongodb-community

La URL por defecto será: mongodb://localhost:27017/project-base-dev

Opción 2: MongoDB Atlas (Cloud - Recomendado para producción)

  1. Crea una cuenta en MongoDB Atlas
  2. Crea un cluster gratuito
  3. Configura acceso de red (IP Whitelist)
  4. Crea un usuario de base de datos
  5. Obtén la cadena de conexión y úsala en MONGODB_URI

🏗️ Estructura del Proyecto

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

🌍 Internacionalización (i18n)

El proyecto incluye soporte completo para múltiples idiomas:

Idiomas disponibles

  • 🇪🇸 Español (por defecto)
  • 🇺🇸 Inglés

Agregar un nuevo idioma

  1. Crea un nuevo archivo en front-app/public/i18n/:

    cp public/i18n/es.json public/i18n/fr.json
  2. Traduce el contenido del archivo

  3. Actualiza la configuración en front-app/src/app/app.config.ts:

    availableLangs: ['en', 'es', 'fr'],

Usar traducciones en componentes

<!-- En templates -->
<h1>{{ 'LOGIN.HEADER.TITLE' | transloco }}</h1>

<!-- En TypeScript -->
this.translocoService.translate('LOGIN.HEADER.TITLE')

🎨 Sistema de Temas

El proyecto incluye un sistema de temas inteligente:

Modos disponibles

  • 🖥️ Automático - Detecta y sigue la preferencia del sistema
  • ☀️ Claro - Fuerza modo claro
  • 🌙 Oscuro - Fuerza modo oscuro

Personalizar colores

Edita front-app/src/app/theme/custom-theme.ts para personalizar la paleta de colores.


🚀 Scripts Disponibles

Backend (back-app/)

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           # Linter

Frontend (front-app/)

npm 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ódigo

📱 Responsive Design

El proyecto está optimizado para todos los dispositivos:

  • 📱 Mobile (320px+)
  • 📊 Tablet (768px+)
  • 🖥️ Desktop (1024px+)
  • 🖥️ Large Desktop (1440px+)

🔒 Seguridad

Características implementadas

  • ✅ 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

Recomendaciones adicionales

  • Usar HTTPS en producción
  • Configurar rate limiting
  • Implementar CSP headers
  • Auditar dependencias regularmente: npm audit

🐛 Testing

Frontend

cd front-app
npm run test           # Tests unitarios con Karma + Jasmine
npm run test:coverage  # Coverage report

Backend

cd back-app
npm run test           # Tests unitarios con Jest
npm run test:e2e       # Tests de integración
npm run test:cov       # Coverage report

📦 Deployment

Frontend (Vercel/Netlify)

npm run build
# Subir carpeta dist/ a tu servicio de hosting

Backend (Railway/Heroku/VPS)

npm run build
npm run start:prod

Configuración en producción

No olvides actualizar el archivo back-app/src/config/config.ts con los valores de producción antes de hacer el deployment.


🤝 Contribuir

  1. Fork el proyecto
  2. Crea una rama para tu feature (git checkout -b feature/nueva-funcionalidad)
  3. Commit tus cambios (git commit -m 'Agregar nueva funcionalidad')
  4. Push a la rama (git push origin feature/nueva-funcionalidad)
  5. Abre un Pull Request

📄 Licencia

Este proyecto está bajo la licencia MIT. Ver el archivo LICENSE para más detalles.


🙋‍♂️ Autor

Borja Sahuquillo Ferrer


¡Feliz coding! 🚀

About

Starter de Angular 20 y Nest.js con Mongodb con Auth - SSO en Google para iniciar un proyecto en cuestión de minutos.

Resources

Stars

1 star

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages