sebu5683/grpc-go-angular repository overview

⁠🛠️ Angular + Go with gRPC

⁠Overview

This repository demonstrates how to integrate an Angular frontend with a Go backend using the gRPC protocol. By leveraging Protocol Buffers (protobufs), we ensure efficient and structured communication between services.

⁠Features

✅ Full-stack gRPC implementation (Angular + Go)
✅ Supports gRPC-Web for browser-based communication
✅ Secure authentication with JWT
✅ PostgreSQL database integration via GORM
✅ Dockerized for easy deployment

⁠Technologies Used

⁠🔹 Angular

• @ngx-grpc/core – Connects Angular to the gRPC server
• @ngx-grpc/improbable-eng-grpc-web-client – Enables gRPC-Web support
• google-protobuf – Handles protobuf serialization
• ngx-toastr – Displays user-friendly notifications

⁠🔹 Go

• google.golang.org/grpc – Implements gRPC server
• github.com/improbable-eng/grpc-web – Enables gRPC-Web support
• gorm.io/gorm & gorm.io/driver/postgres – Database ORM and PostgreSQL driver
• github.com/golang-jwt/jwt/v4 – Handles authentication

⁠Getting Started

⁠🐳 Pull & Run the Docker Image

docker pull sebu5683/grpc-go-angular:latest
docker run -d -p 80:80 --name grpc-server sebu5683/grpc-go-angular

⁠📌 Environment Variables

⁠🔹 Database Configuration (PostgreSQL)

• POSTGRES_USER → PostgreSQL username used for authentication.
• POSTGRES_PASSWORD → Password for the PostgreSQL user.
• POSTGRES_DB → Name of the database to be created in PostgreSQL.

⁠🔹 API Configuration (Backend)

• PORT → The port on which the Go gRPC server runs.
• DB_HOST → The hostname or IP address of the database server (e.g., localhost or a container name in Docker).
• DB_PORT → The port used by PostgreSQL (default: 5432).
• DB_USERNAME → The username that the backend service uses to connect to the database.
• DB_PASSWORD → The password for the database user in the backend.
• DB_NAME → The name of the database that the backend service connects to.

⁠🔹 Security & Authentication

• JWT_SECRET → Secret key used for signing JSON Web Tokens (JWT) for authentication.

⁠🔹 Frontend Configuration

• API_BASE_URL → The base URL that the Angular frontend uses to make API requests to the backend.

⁠📚 Resources

• gRPC Go Quickstart⁠
• GORM Documentation⁠
• ngx-grpc GitHub⁠
• Demo Url⁠
  • username: admin
  • password: admin
• 🔗 GitHub Repo: angular-go-grpc-protocol⁠

🚀 Start building efficient, scalable microservices today!