https://github.com/ralscha/base-chat
https://github.com/ralscha/base-chat
Last synced: 17 days ago
JSON representation
- Host: GitHub
- URL: https://github.com/ralscha/base-chat
- Owner: ralscha
- License: mit
- Created: 2026-04-19T12:29:42.000Z (2 months ago)
- Default Branch: main
- Last Pushed: 2026-05-30T16:07:05.000Z (27 days ago)
- Last Synced: 2026-05-30T18:06:30.769Z (26 days ago)
- Language: HTML
- Size: 122 KB
- Stars: 0
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# BaseChat
BaseChat is the **frontend foundation** for a real-time chat application. It provides the complete UI layer — authentication, contact management, and direct messaging — ready to be paired with a compatible backend.
## Tech Stack
| Layer | Technology |
| --------------- | ---------------------------------------------------------------------------- |
| Framework | [Angular](https://angular.dev) 21 |
| Styling | [Tailwind CSS](https://tailwindcss.com) 4 + [daisyUI](https://daisyui.com) 5 |
| Language | TypeScript 5.9 |
| Package Manager | [Bun](https://bun.sh) |
| Linting | ESLint + angular-eslint |
| Formatting | Prettier |
## Features
- **Authentication** — sign in, sign up, forgot/reset password, passkey support
- **Contacts** — contact list, add, remove, block, unblock
- **Direct Messaging** — conversation list, message history, send/delete messages, unread badges
- **Profile** — view & update profile, change password, passkey management, account deletion
- **Real-time** — client ready for server-pushed events via [Centrifugo](https://centrifugal.dev)
- **Theming** — light/dark mode toggle (daisyUI themes)
## Getting Started
```bash
# Install dependencies
bun install
# Start the development server
bun start
# Build for production
bun run build
# Lint
bun run lint
# Format
bun run format
```
The dev server runs at `http://localhost:4200`.
## Backend Contract
The [backend API contract](docs/backend-api.md) defines the expected HTTP endpoints and Centrifugo channel conventions. The frontend is designed to connect to any backend that implements this contract.
## Project Structure
```
src/app/
├── core/ # Guards, models, services
├── features/ # Feature modules: auth, chat, contacts, profile
├── layouts/ # Auth layout & main layout (sidebar + content)
└── shared/ # Reusable components, pipes
```