Skip to content

Enhancement: Add Resala as a real-world ASP.NET Core application reference #37658

Description

@amdnaji

Description

I would like to propose adding Resala as a real-world ASP.NET Core application reference in the ASP.NET Core documentation.

Resala is an open-source, self-hosted team messaging application built with ASP.NET Core. In particular, it provides a practical example of using ASP.NET Core SignalR in a complete real-world application, rather than only in an isolated tutorial or minimal sample.

Repository: https://github.com/amdnaji/resala

Why this would be useful

The ASP.NET Core documentation contains many focused samples that are excellent for learning individual features. However, developers can also benefit from seeing how those concepts come together in a complete application.

Resala can serve as a practical reference for developers learning how SignalR can be integrated into a larger ASP.NET Core application to provide real-time functionality.

The project uses SignalR for real-time communication between the backend and clients, including messaging and other interactive features. This gives developers an opportunity to see how SignalR fits into an application with authentication, persistence, configuration, and a frontend, rather than looking at real-time communication in isolation.

Resala demonstrates several ASP.NET Core concepts in the context of a real application, including:

  • ASP.NET Core SignalR for real-time communication
  • ASP.NET Core backend development
  • Authentication and authorization
  • LDAP / Active Directory integration
  • Entity Framework Core
  • PostgreSQL
  • Configuration through appsettings and environment variables
  • Docker and Docker Compose deployment
  • Automated tests
  • Integration with a React frontend
  • A production-oriented application structure

For example, the repository includes a dedicated ASP.NET Core backend under src/Resala.Backend, uses PostgreSQL for persistence, supports both standalone authentication and LDAP authentication, and uses SignalR to enable real-time messaging and other interactive functionality.

Proposed documentation change

If appropriate for the ASP.NET Core documentation, add Resala to a relevant page as a real-world/community application reference, particularly where readers are looking for examples of ASP.NET Core SignalR being used in a complete application.

The reference could be as simple as:

Resala — An open-source, self-hosted team messaging application built with ASP.NET Core, demonstrating SignalR for real-time communication alongside authentication, LDAP/Active Directory integration, PostgreSQL, Docker, and a React frontend.
https://github.com/amdnaji/resala

Thank you for considering the proposal.

Activity

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

No one assigned

    Type

    No type

    Projects

    No projects

      Milestone

      No milestone

      Relationships

      None yet

      Development

      No branches or pull requests

      Issue actions