bitfoundation / bitplatform

Build all of your apps using what you already know and love ❤️

🧾 Introduction

At bitplatform, we've curated a comprehensive toolkit to empower you in crafting the finest projects using Blazor. Diverging from others merely offering UI Toolkits, bit BlazorUI components distinguishes itself with over 56 components, with a compact size of under 400 KB. These components boast both Dark and Light Themes, delivering unparalleled High Performance 🚀

Yet, bitplatform doesn't stop there. Our platform introduces exclusive tools that elevate your development experience:

Bswup: This unique tool harnesses the power of Progressive Web Apps (PWA) within the innovative new structure of dotnet 8. By amalgamating pre-rendering techniques reminiscent of renowned platforms like GitHub, Reddit, and Facebook, Bswup ensures an exceptional user experience 😍

Butil: Embracing Blazor because of your love for C#? Butil enables you to stay true to that sentiment by providing essential Browser APIs in C#, eliminating the need to revert to JavaScript for any functionality 👌

Besql: Dreaming of an offline web application capable of saving data and syncing later? Enter Besql, your solution to incorporating ef core & sqlite in your browser. It's a crucial aid for achieving this objective seamlessly 🕺

Bit Boilerplate Project Template: If the aforementioned features have piqued your interest, dive into the Bit Boilerplate project template. Experience everything mentioned above along with additional features such as ASP.NET Core Identity integration, multilingualism, and other cool features that empowers you to develop unified Web, Android, iOS, Windows, and macOS apps from a single codebase, while providing seamless integration with native platform features and third-party Java, Kotlin, Swift, Objective-C, and JavaScript libraries 💯

For more details, visit us at bitplatform.dev.

Note: This project is tested with BrowserStack.

🎁 OSS Showcases

The following apps are our open-source projects powered by the bit platform showcasing the different capabilities of our toolchain:

	Web	iOS	Android	Windows	macOS
bit BlazorUI
Todo
AdminPanel
bitplatform

1. bitplatform.dev: Pre-rendered SPA with Blazor WebAssembly
2. blazorui.bitplatform.dev: Pre-rendered PWA with Blazor Auto
3. todo.bitplatform.dev: Pre-rendered PWA with Blazor WebAssembly
4. static-todo.bitplatform.dev: PWA with Blazor WebAssembly Standalone (Hosted on Cloudflare Pages)
5. adminpanel.bitplatform.dev: PWA with Blazor WebAssembly

Todo & Adminpanel web apps will launch their respective Android and iOS applications if you have already installed them, mirroring the behavior of apps like YouTube and Instagram.

Prerendering combined with PWA functionality delivers an experience akin to that of GitHub and Reddit. The bitplatform solution, seamlessly integrated with the innovative new .NET 8 project structure, stands as the exclusive remedy for such a scenario within the realm of Blazor.

How to contribute?

We welcome contributions! Many people all over the world have helped make this project better.

• Contributing explains what kinds of contributions we welcome.
• Build Instructions explains how to build and test.
• Get Up and Running on bit platform explains how to get the latest builds and their libraries to test them in your own projects.

Contributions

bitplatform's Issues

Ability to have multiple Foundation VSPackage extensions side by side

To support this we've to rename FoundationVSPackageConfiguratio.json to something like FoundationVSPackageConfigurationV1,json. In this naming convention V1 can be V2 etc to show major version of FoundationVSPackage VSIX. Each major Version should have its own git repository branch, Its unique name in visual studio marketplace (For example FoundationVSPacakgeV1.vsix), so It would be possible to have major versions side by side on both github and visual studio marketplace. Developers are allowed to install multiple versions at the same time, and when developers open their visual studio solutions, each installed version of vsix can make a decision about it self. For example FoundationVSPackageV2.vsix will continue to work if FoundationVSPackageConfigurationV2.json is presented near .sln file of solution. It is possible to have multiple .json files for one solution, each of them for some projects of that solution.

Sync Service - Sync History integration

Consider following Dto:

ProductDto { Id , LocationId , Name }

And following Query:

productsRepository.GetAll().Where(p => p.LocationId == currentUserLocationId)

So, sync will get all products located in user's location.
Then we update product's location, and because the query will not return that product to client for that user, sync service won't get its data again. Because sync service at client side gets no change, it will show that product under its old location.

It would be a good idea to have a change history table with sync service integration, so sync service can understand these types of changes.

Add analyzer to make sure that AsNoTracking is called before queryable method calls on ef 6 db sets

Add VSCode Support in Bit Extensions

create schema for rad components

make stop method of signalR message receiver await-able like what we have done in start method

see:
ed563f0#commitcomment-19890909

radGrid column titles are LTR instead of RTL

I've written this style to make rad grid column titles RTL

    thead.k-grid-header > tr > .k-header {
        text-align: right;
    }

Bit VS Extension Visual Studio 2017 Support

Best Practice For Using Image in Bit

Hi There
I Was Trying To Use Byte Array To Save My Picture But The Code Generator Had Some Issue We That.
What Should I Do?

Non key property ("Id") in Dto problem

I've got a Dto that has a property named "Id" but it's not a Key and I'm gonna update it's value later using jaydata, but unfortunately it's way seems make some un handled problems

Null action parameter had been sent successfully but can't return

merge all repositories after Ef core find support

Ef core has supported find linq method eventually in latest of it's version and I think it's time to merge all repositories to a one repo
let's do it soon ;))

Rad components keyboard integration

For example, whenever we press F2, we should click rad-grid-edit-button of current grid's row, to respect it's ng-disabled if any.

create default editor config file

simple odata client can't call odata action with null complex/dto

negative value problem in decimal object

Into IndexedDb when we save minus value like "-1000"; saved value is "0000000000000000000000000-1000". So, the problem is here when decimal use regex /^0+(?=\d)/ to clear extra zeros; result is some thing like this : "0-1000"
Try /^0+(?!\.)/ instead of /^0+(?=\d)/.

Log warning when there is a source/destination project in bit config json file which has no equivalent in current solution

Log warning when there is a source/destination project in bit config json file which has no equivalent in current solution

Thanks in advance

Make DtoSetController's default get IQueryable<TDto> method async

Its base implementation is not Async, but this allows to provide Async implementation, by inheriting DtoSetController and overriding Get method in derived classes.
When repository provides Task<IQueryable> GetAll() method, DtoSetController's Get will call the Async version.

grouping in radGrid

I want to group some rows and show the group in my radgrid and if I expand group, show all related rows and if I collapse group , hide all related rows
how can i do this in this radGrid?
examples: http://demos.telerik.com/kendo-ui/grid/aggregates

ComplexType is Identified as Entity in $metadata

I have an action in my DtoController that returns a DTO (SalesBNDetailsDto).

 public virtual SalesBnDetailsDto GetSalesBnDetailsByFullBno(ODataActionParameters parameters)
 {
            string fullBno = (string)parameters["fullBno"];
            int bimegozarId = (int)parameters["bimegozarId"];
            SalesBnDetailsDto salesBnDetails = _salesBnDetailsProvider.GetInfo(fullBno, bimegozarId);

            return salesBnDetails;
 } 

This Dto contains a property named KhodroDto which is a complex type.
When I see $metadata I can observe that KhodroDto is identified as an entity not as a complex type which in turn causes the action to return nothing for KhodroDto, but other properties of SalesBNDetailsDto are filled appropriately.
When I add edmModelBuilder.ComplexType(); in my customized EITEdmModelProvider.BuildEdmModel the problem is gone and every thing works as expected.

 public override void BuildEdmModel(ODataModelBuilder edmModelBuilder)
 {
            edmModelBuilder.ComplexType<KhodroDto>();
            _autoEdmBuilder.AutoBuildEdmFromAssembly(typeof(CarEdmModelProvider).Assembly, edmModelBuilder);
            base.BuildEdmModel(edmModelBuilder);
 }

a best way to reuse sync code in async method

in bit-framework we've something like this following code
public interface ISomeContract { Task<int> SomeMethodAsync(CancellationToken cancellationToken); int SomeMethod(); }
and suppose this implementation of it's contract
public class SomeImplementation : ISomeContract { public int SomeMethod() { // lots of codes ... return 10; } public async Task<int> SomeMethodAsync(CancellationToken cancellationToken) { return SomeMethod(); // another example: I can remove async modifier from SomeMethodAsync method and this following //try //{ // return Task.FromResult<int>(SomeMethod()); //} //catch (Exception ex) //{ // return Task.FromException<int>(ex); //} } }
we have some options to reuse sync method in async implementation
1)
public Task<int> SomeMethodAsync(CancellationToken cancellationToken) { return Task.Run(() => SomeMethod(), cancellationToken); }
2)
public async Task<int> SomeMethodAsync(CancellationToken cancellationToken) { cancellationToken.ThrowIfCancellationRequested(); return SomeMethod(); }
3)
public Task<int> SomeMethodAsync(CancellationToken cancellationToken) { if (cancellationToken.IsCancellationRequested) { return Task.FromCanceled<int>(cancellationToken); } try { return Task.FromResult(SomeMethod()); } catch (OperationCanceledException oce) { var canceledTaskBuilder = new TaskCompletionSource<int>(); canceledTaskBuilder.SetCanceled(); return canceledTaskBuilder.Task; } catch (Exception e) { return Task.FromException<int>(e); } }
more detail in this following:
how to reuse sync code

Add Visual studio for mac support in Bit Extension

Enhanced OData Queryable attribute

1- Kendo Data Source using JayData OData Provider won't ask $count when there is no page size is specified and at client side, $count will be equal to length of returned data from server.

2- Even asking $count will not execute any kind of query to calculate count, if there is no page size is specified by either $top or DefaultPageSize and $count will be the .Length of returned results of original query. (Query will be executed once).

3- By setting DefaultPageSize to null, requests with no $top specified will retrieve all data. (Query will be executed once)

4- Default ASP.NET Web API OData implementation has a key difference, it has a default page size as a required property, and will apply that in all cases. We're going to remove usages of that implementation from our project.

make repository's get method async

Better way to message receiver callback disposal

instead of removing callback method, we should return disposal function on register method, like what $scope.$watch of angular returns.

Passing null parameter raise unhandle client side error

[Action]
        [Parameter("testId", typeof(Guid?))]
        public virtual async Task<TestDto> GetOpensCollectionDeliveryOrders(ODataActionParameters actionParameters, CancellationToken cancellationToken)
        {
            ...
        }

Can't return Task<List<Guid>> in controller

consider the following code

        [Function]
        [Parameter("categoryId", typeof(Guid))]
        public virtual async Task<Guid[]> GetlocationIdsByCategoryId([FromODataUri]Guid categoryId, CancellationToken cancellationToken)
        {
            return await _categoryInLocationsRepository.GetAll().Where(c => c.ProductCategoryId == categoryId).Select(c => c.LocationId).ToArrayAsync(cancellationToken);
        }

above code makes these error
Build:Type 'string' does not satisfy the constraint 'Entity'.

Roslyn Analyzer for Dto|ComplexType classes without default public constructor.

Sending Dtos and Complex Types to clients is possible in Web API OData even for those without public default constructor, but its not possible when client sends data to Web API OData Server. This causes developers to making a mistake ,So we've to enfore having public default ctor for dtos & complex types.

Add debug windows ILogStore implementation

TypeScript client creates instances of dto & complex type when odata server returns null

Pass string parameter which contains / character to Web API OData Function

Example: Car.getSalesBnDetailsByFullBno(fullBno='31/1001/46508',bimegozarId=49705)

Database schema change between app versions management

We need a mechanism to provide old database instance and new database instance to developer, so developer can migrate its data from old db to new db.

Important notes:

1- Database migration approaches like what Entity Framework Migration provides is not come in handy, because of limitations in SQL lite such as lack of "rename column" etc. This approach is not available in indexedDb too.

2- Developer needs to migrate tables/collections with two way sync. Only those records with ISV = false

add best practice for select Primary key by developers

hi

please limit selection primary key types by developers in bit-framework. for example add IEntityWithDefaultIntKey like IEntityWithDefaultGuidKey and remove IEntityWithDefaultKey generic interface. the best practice for primary key types are Int or Guid. other types should not be selected by developers.

best regards.

Problem with $batch returns null

When a server returns null for one of child request of client (No content), we get an unexpected error at client side.
This happens on $batch requests only.

Bind one field to both rad-date-picker & persian-date-picker controls at the same time problem.

<rad-date-picker name="BirthDate" k-ng-model="vm.axaNerkhEstelam.BirthDate" />
<persian-date-picker ng-model="vm.axaNerkhEstelam.BirthDate" />

If I use ng-model on rad-date-picker, changing persian date won't update rad-date-picker, but when I use k-ng-model on rad-date-picker, there won't be any problem.

support for value tuple as odata action paramters

The Diffrence Between jaysvcUtil and Bit Html Client Proxy Generator

1. Bit Code Generator does not generate some properties which are Required.

2. No support for concurrency mode in Bit
   JaySvcUtilSample:
   Version: {
   "concurrencyMode": $data.ConcurrencyMode.Fixed
   }

3. Enum properties have two types of fields: Index & Value (JaySvcUtil)
   Bit Sample:
   { name : 'Man' , value : "Foundation.Test.Model.Dto.TestGender'Man'" },
   JaySvcUtil Sample:
   { "name": "Man", "index": 0, "value": 3 },

4. Bit Code Generator does not generate "Reflect define Metadata"
   JaySvcUtil Sample:
   Reflect.defineMetadata("O1", ["Version"], types["Entity"].prototype)

5. Bit Code Generator, Generate Action & Function In Camel Case Format

complex without dto issue

I have a method that returns a complex type which has never used in any dtos.
we have to consider to these type of complex types in foundation vs package.

file not found

In the foundation project there are some reference like

/// <reference path="../../foundation.core.htmlclient/foundation.core.d.ts" />
/// <reference path="../../foundation.core.htmlclient/foundation.core.d.ts" />
/// <reference path="../../foundation.viewModel.htmlclient/foundation.model.context.d.ts" />

to some files, but those file does not exist.

and also the foundation.core project does not exist too.

/// <reference path="../foundation.core/typings.d.ts" />

rad-grid-view Layout Problem With Grouping

Layout problem with Rad Grid on grouping mode: Extra column on both RTL & LTR + > arrow instead of < arrow in RTL mode.

Insert | Update >> Let's raise an exception in case of unexpected behavior

Consider following scenarios:
1- Update from Dto into model when property of model is internal somehow!
2- Raise an exception when we insert an entity which has a version somehow!

Display message box for all errors it bit + Its best practices

How can I display error message to end user for all errors I get from server responses?
Is there any best practice for this?
Thanks in advance.

Console.set_Title error on running sample on IIS

I was trying to run the bitChangeSetManager on IIS (Windows 10.14393) and I got this error:

IOException: The handle is invalid.
   System.IO.__Error.WinIOError(Int32 errorCode, String maybeFullPath) +1093
   System.Console.set_Title(String value) +112  ....  AppStartup.cs:34

There was no problem on iis express.

OData operation configuration's optional parameter is not working properly

       [Function]
       [Parameter("firstNumber", typeof(int))]
       [Parameter("secondNumber", typeof(int), isOptional: true)]
       public virtual async Task<int> Sum(CancellationToken cancellationToken, [FromODataUri]int firstNumber, [FromODataUri]int secondNumber = 10)
       {
           return firstNumber + secondNumber;
       }

As I tested, generated JavaScript & TypeScript codes of html client are ok, but when I take a look at generated $metadata of DefaultAutoEdmBuilder, I see no IsOptional on that and I see bad request exception when I pass firstNumber, but I get the result when I pass both parameters

video for install bit framework and create a simple web form data entry

Please make a video for install bit framework
and create a simple web form for data entry by bit framework.
Thanks

rad-grid-row directive is not working after we removed view-template from rad grid view

See https://github.com/bit-foundation/bit-framework/blob/006862e09442c9b093c6c303188fa75b2203e17e/Foundation/HtmlClient/Foundation.View.HtmlClient/directives/defaultRadGridDirective.ts#L192-L195

Use Persian Date Time Picker in md-input-container

Error: can only have one , <textarea> or child element!

<md-input-container>
    <persian-date-picker ng-model="vm.axaNerkhEstelam.BirthDate" />
</md-input-container>

Support OData attributes on dto properties like [AutoExpand] attribute while execution odata query

Support odata query on single result responses

Support for $count & $groupBy