https://github.com/bobbylite/dotnet-onlybalds
OnlyBlads platform built with dotnet Blazor and Web Apis. Authenticated and authorized with Auth0 iDp
https://github.com/bobbylite/dotnet-onlybalds
Last synced: 4 months ago
JSON representation
OnlyBlads platform built with dotnet Blazor and Web Apis. Authenticated and authorized with Auth0 iDp
- Host: GitHub
- URL: https://github.com/bobbylite/dotnet-onlybalds
- Owner: bobbylite
- License: gpl-3.0
- Created: 2024-04-21T18:04:20.000Z (about 2 years ago)
- Default Branch: main
- Last Pushed: 2025-12-25T18:35:03.000Z (5 months ago)
- Last Synced: 2025-12-27T05:44:16.112Z (5 months ago)
- Language: C#
- Homepage:
- Size: 7.48 MB
- Stars: 1
- Watchers: 2
- Forks: 0
- Open Issues: 4
-
Metadata Files:
- Readme: README.md
- License: LICENSE
- Security: SECURITY.md
Awesome Lists containing this project
README
# OnlyBalds :bald_man:
OnlyBalds is a Blazor application with a dedicated Web API for backend operations. It's designed to provide a seamless user experience for our bald community.
## :file_folder: Projects
The solution contains three projects:
1. **Blazor Server**: This project handles the server-side rendering of the Blazor application.
2. **Blazor Client**: This project is responsible for the client-side logic and UI of the Blazor application.
3. **Web API**: This project provides the backend for frontend (BFF) implementations, serving as the bridge between the Blazor application and the database.
## :books: Entity Framework with Npgsql for PostgreSQL
OnlyBalds uses **Entity Framework Core** with **Npgsql** to interface with a PostgreSQL database, ensuring efficient data handling and easy integration.
### Database Migrations
1. Create a migration:
```bash
dotnet ef migrations add MigrationName
```
2. Apply the migration:
```bash
dotnet ef database update
```
This approach leverages the repository pattern and multiple DbContexts (e.g., `ThreadDataContext`, `PostDataContext`, `CommentDataContext`) to organize and handle data effectively.
---
## :heart: Health Checks
The application includes health check support to monitor service health. Access health information at `/HealthChecks`:
- **/HealthChecks**: Displays the application's current health status.
---
## :wrench: Build Information
Build information is automatically generated at each build and accessible at the `/build-info.html` endpoint. This page provides key details like:
- Build date and time
- Commit hash
- Build version
---
## 🤖 Hugging Face API Integration
OnlyBalds integrates with the **Hugging Face Inference API** to enhance chat room moderation using AI models:
- **Toxic BERT**: Identifies potentially toxic messages to maintain a respectful environment.
- **Twitter Sentiment**: Analyzes sentiment to ensure positive interactions within the chat.
---
## :rocket: Getting Started
To get started with the OnlyBalds application, follow these steps:
1. Clone the repository: `git clone https://github.com/bobbylite/OnlyBalds.git`
2. Navigate to the project directory: `cd OnlyBalds`
3. Restore the packages: `dotnet restore`
4. Run the application: `dotnet run`
## :computer: Running the Project Locally
To run the OnlyBalds application locally, follow these steps:
### Step 1: Run the BFF Backend
First, you need to run the Backend for Frontend (BFF) which is the Web API project. This project handles the backend operations and serves as the bridge between the Blazor application and the database.
1. Open a terminal or command prompt.
2. Navigate to the project directory: `cd OnlyBalds`
3. Run the BFF backend with the following command:
```sh
dotnet run --project OnlyBalds.Api --launch-profile https
```
### Step 2: Run the Client Application
To run the OnlyBalds client application:
1. Create a launch profile in the properties directory.
2. Use VS Code's debug section to run the profile created in the previous steps.
## :gear: Built With
- [.NET 8](https://dotnet.microsoft.com/en-us/)
- [Blazor](https://dotnet.microsoft.com/apps/aspnet/web-apps/blazor)
- [.NET Core Web API](https://dotnet.microsoft.com/en-us/apps/aspnet/apis)
- [Auth0](https://auth0.com/)
---
## :handshake: Contributing
Contributions, issues, and feature requests are welcome! Feel free to check [issues page](https://github.com/bobbylite/OnlyBalds/issues).
## :memo: License
This project is [MIT](https://choosealicense.com/licenses/mit/) licensed.