README.en.md

Angular 19 – Fullstack Application

👉 Si vous parlez français, la version française est ici :

🔧 CI Status

📦 Versions

---

📚 Table of Contents

• 🔧 CI Status
• 🌐 Live Demo
• 📁 Project Structure
• 🛠 Configuration
• 🔗 Exposed APIs
• ⚙️ Quick Start
• 👤 Author
• 📚 Documentation

---

This repository contains a fullstack web application using Angular 19 + Node.js or TypeScript with PostgreSQL/MySQL or mocked data.

---

🌐 Live Demo

🔗 Check out the Angular demo

---

📁 Project Structure

🧩 Frontend

• frontend-angular
  Angular 19 app (with Routing, Lazy loading, SSR, PWA, SEO)

🚀 Backends

• backend-javascript
  Express.js API in JavaScript (ESM) with PostgreSQL, MySQL or mock data

• backend-typescript
  Express.js API in TypeScript with PostgreSQL, MySQL or mock data

🧪 Technical Starters (bonus)

• backend-javascript-cjs : Node.js (CommonJS), ESLint, Jest, Webpack
• backend-javascript-esm : Node.js (ESM), ESLint, Jest, Webpack
• backend-java21-springboot : Java 21 Spring Boot starter (JUnit)

---

🔧 Frontend Configuration (Angular)

In frontend-angular/src/environments/environment.ts:

useDatabase: false,
backend: 'http://localhost:3000',

useDatabase	Mode
false	Mocked data handled in frontend
true	Real data fetched from backend

---

🛠 Backend Configuration

In .env file:

PORT=3000
DB_CLIENT=mock # mock | pg | mysql

DB_CLIENT	Data Source
mock	Mocked data
pg	PostgreSQL
mysql	MySQL

---

🔗 Exposed APIs

Resource	URL
Continents	http://localhost:3000/continents
Cities	http://localhost:3000/cities
Countries	http://localhost:3000/countries
Persons	http://localhost:3000/persons
Professions	http://localhost:3000/professions

---

⚙️ Quick Start

▶️ Clone the project

git clone https://github.com/ganatan/angular-app.git
cd angular-app

▶️ Frontend Angular

cd frontend-angular
npm install
npm start
# http://localhost:4200

▶️ Backend JavaScript

cd backend-javascript
npm install
npm start
# http://localhost:3000

▶️ Backend TypeScript

cd backend-typescript
npm install
npm start
# http://localhost:3000

---

👤 Author

• Danny – www.ganatan.com

---

📚 Documentation

• 🇫🇷 French tutorials
• 🇬🇧 English tutorials