Build Configuration

Build and publish related options are configured in .csproj file via MSBuild properties.

Property	Default	Description
BootsharpName	bootsharp	Name of the generated JavaScript module.
BootsharpEmbedBinaries	true	Whether to embed binaries to the JavaScript module file.
BootsharpBundleCommand	npx rollup	The command to bundle generated JavaScrip solution.
BootsharpPublishDirectory	/bin	Directory to publish generated JavaScript module.
BootsharpTypesDirectory	/types	Directory to publish type declarations.
BootsharpBinariesDirectory	/bin	Directory to publish binaries when EmbedBinaries disabled.
BootsharpPackageDirectory	/	Directory to publish package.json file.

Below is an example configuration, which will make Bootsharp name compiled module "backend" (instead of the default "bootsharp"), publish the module under solution directory root (instead of "/bin") and disable binaries embedding in favor of publishing them under "public/bin" directory one level above the solution root:

<Project Sdk="Microsoft.NET.Sdk">

    <PropertyGroup>
        <TargetFramework>net10.0</TargetFramework>
        <RuntimeIdentifier>browser-wasm</RuntimeIdentifier>
        <BootsharpName>backend</BootsharpName>
        <BootsharpPackageDirectory>$(SolutionDir)</BootsharpPackageDirectory>
        <BootsharpEmbedBinaries>false</BootsharpEmbedBinaries>
        <BootsharpBinariesDirectory>$(SolutionDir)../public/bin</BootsharpBinariesDirectory>
    </PropertyGroup>

    <ItemGroup>
        <PackageReference Include="Bootsharp" Version="*-*"/>
    </ItemGroup>

</Project>

Globalization

By default, Bootsharp disables .NET globalization on WASM. This keeps the published output smaller, but culture-specific formatting and culture construction will use invariant mode.

To enable globalization, explicitly disable invariant globalization in your project file:

<PropertyGroup>
    <InvariantGlobalization>false</InvariantGlobalization>
</PropertyGroup>

When invariant globalization is disabled, Bootsharp will automatically include the ICU files emitted by the .NET WASM build and configure the runtime accordingly. This works for both embedded and sideloaded binaries.

Bootsharp supports the following globalization modes:

Mode	How to enable	Behavior
Sharded	Didable InvariantGlobalization	Publishes the default sharded ICU files (icudt_*.dat).
Full	Didable InvariantGlobalization and enable WasmIncludeFullIcuData	Publishes the full ICU data file (icudt.dat) and supports many cultures in one runtime.