blazordevlab/blazorpocketapp repository overview

⁠BlazorPocket

BlazorPocket is a lightweight web application template that leverages the latest .NET 8.0 Blazor Web App with InteractiveAuto render mode and PocketBase for backend data storage. This project aims to streamline the development process, minimize repetitive coding, and provide a quick start for building efficient web applications.

⁠Features

• Blazor Web App with .NET 8.0: Utilizes the latest features and improvements in .NET 8.0 Blazor.
• InteractiveAuto Render Mode: Offers enhanced interactivity and responsiveness.
• PocketBase Integration: Simple and efficient data storage solution with PocketBase.
• Quick Setup: Pre-configured to reduce setup time and repetitive coding.

⁠Getting Started

⁠Demo

• https://blazorpocket.blazorserver.com/⁠
• https://blazorpocket.blazors.app⁠

⁠docker compose file

version: '3.8'
services:
  blazorpocketapp:
    image: blazordevlab/blazorpocketapp:0.0.6-pre.73720a4
    environment:
      - UseInMemoryDatabase=false
      - ASPNETCORE_ENVIRONMENT=Development
      - ASPNETCORE_URLS=http://+:80;https://+:443
      - ASPNETCORE_HTTP_PORTS=80
      - ASPNETCORE_HTTPS_PORTS=443
      - AppSetting__AppName='${AppName}'
      - AppSetting__Version='${Version}'
      - AppSetting__ProcketbaseUrl='${ProcketbaseUrl}'   
    ports:
      - "8023:80"
      - "8024:443"
  pocketbase:
    image: blazordevlab/blazorpocketbase:0.0.5
    ports:
      - "8025:8080"
    volumes:
      - pocketbase_data:/pb/pb_data 
volumes:
  pocketbase_data:

⁠Prerequisites

• .NET 8.0 SDK⁠
• PocketBase⁠
• Node.js⁠ (for front-end development)

⁠Installation

1. Clone the repository:

   git clone https://github.com/neozhu/BlazorPocket.git
   cd BlazorPocket
   

   Copy

2. Add PocketBaseClient subtree:

   git subtree add --prefix pbcodegen https://github.com/iluvadev/PocketBaseClient.git main --squash
   

   Copy

3. Add PocketBase C# SDK subtree:

   git subtree add --prefix sdk https://github.com/iluvadev/pocketbase-csharp-sdk.git master --squash
   

   Copy

4. Setup PocketBase:

   • Download and run PocketBase following the official documentation⁠.
   • Configure the PocketBase instance and make note of the endpoint URL.
   • pocketbase default admin and password

   [email protected]
   admin12345!
   

   Copy
   • login with demo and password

   [email protected]
   demo12345!
   

   Copy

5. Configure the Blazor App:

   • Update the configuration file in the Blazor project to point to your PocketBase instance.

6. Restore .NET dependencies:

   dotnet restore
   

   Copy

7. Build and run the Blazor App:

   dotnet run
   

   Copy

⁠Usage

• Open your browser and navigate to https://localhost:5001.
• You should see the BlazorPocket application running.
• Explore the sample components and understand the integration with PocketBase.

⁠Project Structure

• /BlazorPocket.Client: Contains the Blazor WebAssembly project.
• /BlazorPocket.Server: Contains the ASP.NET Core server project.
• /BlazorPocket.Shared: Contains shared code and models.

⁠Contributing

Contributions are welcome! Please feel free to submit issues, fork the repository, and send pull requests.

1. Fork the repository.
2. Create a new feature branch (git checkout -b feature/your-feature).
3. Commit your changes (git commit -m 'Add your feature').
4. Push to the branch (git push origin feature/your-feature).
5. Create a new Pull Request.

⁠License

This project is licensed under the MIT License. See the LICENSE⁠ file for details.

⁠Acknowledgements

• .NET Team⁠ for creating an amazing development framework.
• PocketBase Team⁠ for providing a simple and efficient backend solution.