README.en.md

Angular 19 – Fullstack Application

👉 Si vous ne parlez pas anglais, la version française est ici :

This repository contains a fullstack web application :

• frontend-angular: Angular 19 frontend application
• backend-javascript: Javascript API using mocked or real data (PostgreSQL/MySQL)
• backend-typescript: Typescript API using mocked or real data (PostgreSQL/MySQL)

---

🌐 Live Demo

Check the demo

---

📁 Project Structure

🧩 Frontend

• frontend-angular
  Angular 19 application (including Routing, Lazy Loading, SSR, PWA, SEO).

---

🚀 Backends

• backend-javascript
  Express.js API in JavaScript (ESM)
  Uses either mocked data or a real database (PostgreSQL/MySQL)

• backend-typescript
  Express.js API in TypeScript
  Uses either mocked data or a real database (PostgreSQL/MySQL)

• backend-java21-springboot
  Starter Java21 Spring Boot (JUnit)

---

🧪 Technical Starters (bonus)

• backend-javascript-commonjs
  JavaScript Node.js starter using CommonJS (require/module.exports, ESLint, Jest, Webpack)

• backend-javascript-esm
  JavaScript Node.js starter using ESM (import/export, ESLint, Jest, Webpack)

---

🔧 Frontend Configuration (Angular)

In environment.ts :

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

useDatabase	Mode
false	Mocked data on the frontend
true	Real data provided by the backend

---

🛠 Backends Configuration

Dans le fichier .env :

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

DB_CLIENT	Source de données
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

▶️ Angular Frontend

git clone https://github.com/ganatan/angular-app.git
cd angular-app/frontend-angular
npm install
npm start

🔗 http://localhost:4200

---

▶️ Node.js Backend (ESM)

cd angular-app/backend-javascript
npm install
npm start

🔗 http://localhost:3000

---

▶️ TypeScript Backend

cd angular-app/backend-typescript
npm install
npm start

🔗 http://localhost:3000

---

👤 Author

• Danny – www.ganatan.com

---

📚 Documentation

• 🇬🇧 Tutorials in English
• 🇫🇷 Tutoriels en français