Secure, Anonymous End-to-End Encrypted Messenger
Sentre is a modern, secure messaging application built with privacy and security as core principles. Featuring end-to-end encryption, real-time messaging, and a clean, intuitive user interface, Sentre provides a safe space for private communications.
- End-to-End Encryption - All messages are encrypted using industry-standard protocols
- Real-Time Messaging - Instant message delivery with WebSocket connections
- Anonymous Registration - Optional anonymous account creation
- Responsive Design - Works seamlessly on desktop and mobile devices
- Framework: Angular 17+
- UI Library: Angular Material
- Styling: SCSS with CSS Variables
- Build Tool: Angular CLI
- Runtime: .NET 8 & .NET 10
- Framework: ASP.NET Core Web API
- Database: PostgreSQL
- ORM: Entity Framework Core 10
- Authentication: JWT with refresh tokens
- Encryption: libsodium / crypto
- Real-time: SignalR
- Version Control: Git
- CI/CD: GitHub Actions
- Node.js 18+ and npm
- PostgreSQL 17.7 (local or cloud)
- .Net 8 & .Net 10
- Git
-
Clone the repository
git clone https://github.com/IvanGazul/Sentre.git cd Sentre -
Install dependencies
# Install frontend dependencies cd frontend npm install
-
Start the application
# Start frontend ng serve # Start backend dotnet run --project Sentre.Presentation
-
Access the application
- Frontend: http://localhost:4200
- Backend API: https://localhost:7026
- Backend Swagger (debug build only): https://localhost:7026/swagger
Sentre.Frontend/
├── 📁 public/
├── 📁 src/
│ ├── 📁 app/
│ │ ├── 📁 components/
│ │ │ ├── 📁 message-input/
│ │ │ │ ├── 📄 message-input.component.html
│ │ │ │ ├── 📄 message-input.component.scss
│ │ │ │ ├── 📄 message-input.component.spec.ts
│ │ │ │ └── 📄 message-input.component.ts
│ │ │ ├── 📁 message-item/
│ │ │ │ ├── 📄 message-item.component.html
│ │ │ │ ├── 📄 message-item.component.scss
│ │ │ │ ├── 📄 message-item.component.spec.ts
│ │ │ │ └── 📄 message-item.component.ts
│ │ │ ├── 📁 message-list/
│ │ │ │ ├── 📄 message-list.component.html
│ │ │ │ ├── 📄 message-list.component.scss
│ │ │ │ ├── 📄 message-list.component.spec.ts
│ │ │ │ └── 📄 message-list.component.ts
│ │ │ ├── 📁 notification-container/
│ │ │ │ └── 📄 notification-container.component.ts
│ │ │ └── 📁 welcome-page/
│ │ │ ├── 📄 welcome-page.component.html
│ │ │ ├── 📄 welcome-page.component.scss
│ │ │ ├── 📄 welcome-page.component.spec.ts
│ │ │ └── 📄 welcome-page.component.ts
│ │ ├── 📁 constants/
│ │ │ └── 📄 validation.constants.ts
│ │ ├── 📁 interceptors/
│ │ │ └── 📄 auth.interceptor.ts
│ │ ├── 📁 interfaces/
│ │ │ ├── 📄 interfaces.service.spec.ts
│ │ │ └── 📄 interfaces.service.ts
│ │ ├── 📁 pages/
│ │ │ └── 📁 chat/
│ │ │ ├── 📄 chat.component.html
│ │ │ ├── 📄 chat.component.scss
│ │ │ ├── 📄 chat.component.spec.ts
│ │ │ └── 📄 chat.component.ts
│ │ ├── 📁 services/
│ │ │ ├── 📄 api.service.ts
│ │ │ ├── 📄 chat.service.ts
│ │ │ ├── 📄 notification.service.ts
│ │ │ ├── 📄 session.service.ts
│ │ │ └── 📄 websocket.service.ts
│ │ ├── 📄 app.component.html
│ │ ├── 📄 app.component.scss
│ │ ├── 📄 app.component.spec.ts
│ │ ├── 📄 app.component.ts
│ │ ├── 📄 app.config.ts
│ │ └── 📄 app.routes.ts
│ ├── 📄 index.html
│ ├── 📄 main.ts
│ └── 📄 styles.scss
├── 📄 .editorconfig
├── 📄 .gitignore
├── 📄 angular.json
├── 📄 package-lock.json
├── 📄 package.json
├── 📄 README.md
├── 📄 tsconfig.app.json
├── 📄 tsconfig.json
└── 📄 tsconfig.spec.json
Sentre.Backend/
├── 📁 Sentre.Application/
│ ├── 📁 Abstractions/
│ │ ├── 📁 Data/
│ │ │ ├── 📄 IAppDbContext.cs
│ │ │ ├── 📄 IChatRepository.cs
│ │ │ ├── 📄 IMessageRepository.cs
│ │ │ ├── 📄 ISessionRepository.cs
│ │ │ └── 📄 IUnitOfWork.cs
│ │ ├── 📁 Messaging/
│ │ │ ├── 📄 IChatHubClient.cs
│ │ │ └── 📄 IChatNotificationService.cs
│ │ ├── 📁 Security/
│ │ │ ├── 📄 IChallengeService.cs
│ │ │ ├── 📄 IJwtTokenGenerator.cs
│ │ │ └── 📄 IKeyExchangeService.cs
│ │ └── 📄 IDateTimeProvider.cs
│ ├── 📁 Common/
│ │ └── 📁 Algorithms/
│ │ └── 📄 LevenshteinDistance.cs
│ ├── 📁 DTOs/
│ │ ├── 📄 ChatDto.cs
│ │ ├── 📄 MessageDto.cs
│ │ └── 📄 UserDto.cs
│ ├── 📁 Features/
│ │ ├── 📁 Auth/
│ │ │ ├── 📁 Challenge/
│ │ │ │ ├── 📄 GetChallengeQuery.cs
│ │ │ │ └── 📄 GetChallengeQueryHandler.cs
│ │ │ ├── 📁 Login/
│ │ │ │ ├── 📄 LoginCommand.cs
│ │ │ │ └── 📄 LoginCommandHandler.cs
│ │ │ ├── 📁 Logout/
│ │ │ │ ├── 📄 LogoutCommand.cs
│ │ │ │ └── 📄 LogoutCommandHandler.cs
│ │ │ └── 📁 Register/
│ │ │ ├── 📄 RegisterCommand.cs
│ │ │ └── 📄 RegisterCommandHandler.cs
│ │ ├── 📁 Chats/
│ │ │ ├── 📁 DeleteChat/
│ │ │ │ ├── 📄 DeleteChatCommand.cs
│ │ │ │ └── 📄 DeleteChatCommandHandler.cs
│ │ │ ├── 📁 GetChatMessages/
│ │ │ │ ├── 📄 GetChatMessagesQuery.cs
│ │ │ │ └── 📄 GetChatMessagesQueryHandler.cs
│ │ │ └── 📁 GetMyChats/
│ │ │ ├── 📄 GetMyChatsQuery.cs
│ │ │ └── 📄 GetMyChatsQueryHandler.cs
│ │ ├── 📁 Conversations/
│ │ │ ├── 📁 Events/
│ │ │ │ └── 📄 ChatCreatedEvent.cs
│ │ │ └── 📁 StartConversation/
│ │ │ ├── 📄 StartConversationCommand.cs
│ │ │ └── 📄 StartConversationCommandHandler.cs
│ │ ├── 📁 Messages/
│ │ │ ├── 📁 Events/
│ │ │ │ └── 📄 MessageSentEvent.cs
│ │ │ └── 📁 SendMessage/
│ │ │ ├── 📄 SendMessageCommand.cs
│ │ │ └── 📄 SendMessageCommandHandler.cs
│ │ └── 📁 Users/
│ │ ├── 📁 GetUserByUsername/
│ │ │ ├── 📄 GetUserByUsernameQuery.cs
│ │ │ └── 📄 GetUserByUsernameQueryHandler.cs
│ │ └── 📁 SearchUsers/
│ │ ├── 📄 SearchUsersQuery.cs
│ │ └── 📄 SearchUsersQueryHandler.cs
│ └── 📄 DependencyInjection.cs
├── 📁 Sentre.Domain/
│ ├── 📁 Constants/
│ │ └── 📄 ValidationConstants.cs
│ ├── 📁 Entities/
│ │ ├── 📄 Chat.cs
│ │ ├── 📄 Message.cs
│ │ └── 📄 Session.cs
│ ├── 📁 Enums/
│ ├── 📁 Exceptions/
│ │ ├── 📄 ChatAlreadyExistsException.cs
│ │ ├── 📄 ChatNotFoundException.cs
│ │ ├── 📄 NicknameAlreadyTakenException.cs
│ │ ├── 📄 NicknameInvalidException.cs
│ │ ├── 📄 NicknameTooLongException.cs
│ │ ├── 📄 SessionExpiredException.cs
│ │ ├── 📄 SessionNotFoundException.cs
│ │ └── 📄 UnauthorizedChatAccessException.cs
│ └── 📁 Primitives/
│ ├── 📄 DomainEvent.cs
│ └── 📄 Entity.cs
├── 📁 Sentre.Infrastructure/
│ ├── 📁 BackgroundJobs/
│ │ └── 📄 MessageCleanupJob.cs
│ ├── 📁 Configurations/
│ │ ├── 📄 ChatConfiguration.cs
│ │ ├── 📄 MessageConfiguration.cs
│ │ └── 📄 SessionConfiguration.cs
│ ├── 📁 Messaging/
│ │ └── 📄 ChatNotificationService.cs
│ ├── 📁 Migrations/
│ ├── 📁 Persistence/
│ │ ├── 📄 AppDbContext.cs
│ │ └── 📄 UnitOfWork.cs
│ ├── 📁 Repositories/
│ │ ├── 📄 ChatRepository.cs
│ │ ├── 📄 MessageRepository.cs
│ │ └── 📄 SessionRepository.cs
│ ├── 📁 Security/
│ │ ├── 📄 ChallengeService.cs
│ │ ├── 📄 JwtTokenGenerator.cs
│ │ └── 📄 KeyExchangeService.cs
│ └── 📄 DependencyInjection.cs
└── 📁 Sentre.Presentation/
├── 📁 Properties/
│ └── 📄 launchSettings.json
├── 📁 Controllers/
│ ├── 📄 ApiControllerBase.cs
│ ├── 📄 AuthController.cs
│ ├── 📄 ChatController.cs
│ ├── 📄 MessagesController.cs
│ └── 📄 UsersController.cs
├── 📁 Hubs/
│ ├── 📄 ChatCreatedEventHandler.cs
│ ├── 📄 ChatHub.cs
│ └── 📄 MessageSentEventHandler.cs
├── 📁 Middleware/
│ └── 📄 GlobalExceptionHandler.cs
├── 📄 appsettings.json
└── 📄 Program.cs
- End-to-End Encryption: Messages encrypted with Curve25519, XSalsa20, and Poly1305
- Perfect Forward Secrecy: New encryption keys for each conversation
- Zero-Knowledge Architecture: Server cannot decrypt user messages
- Secure Authentication: JWT tokens with refresh token rotation
- Rate Limiting: Protection against brute force attacks
- Input Validation: Comprehensive request validation
- HTTPS Only: Secure transport layer encryption
We welcome contributions to Sentre! Please follow these steps:
- Fork the repository
- Create a feature branch
git checkout -b feature/amazing-feature
- Make your changes
- Commit your changes
git commit -m "Add amazing feature" - Push to your branch
git push origin feature/amazing-feature
- Open a Pull Request
- Issues: GitHub Issues
- Discussions: GitHub Discussions
- Email: ivan.gazul@isa.utm.md | pavel.chirtoca@isa.utm.md
Made with ❤️ for secure communications