BlazorForKids.Tool 3.0.7

🧰 BlazorForKids.Tool (bkcli)

bkcli is the official command-line tool for the BlazorForKids framework — a simplified yet powerful development environment built on top of Blazor Server.

This tool is essential for initializing, managing, and maintaining BlazorForKids projects. It is not a general-purpose CLI and is designed exclusively for use with applications built using the BlazorForKids SDKs.

🔗 Part of the BlazorForKids Framework

BlazorForKids is a developer-friendly framework that helps you build modern Blazor Server apps faster and with less friction. It's built for developers who value clarity, productivity, and structured guidance.

The framework includes:

• ✅ Solution templates for clean architecture (Domain + Web projects)
• ✅ Automatic code generation via source generators
• ✅ Rich UI components and scaffolding support
• ✅ Simplified setup using this CLI tool

To learn more about the framework itself, visit blazor-for-kids.com or check out the full documentation.

⚙️ What Does bkcli Do?

The bkcli tool automates and simplifies many tasks you need while working with BlazorForKids projects:

• 🔐 Register and validate your developer license
• 🛠 Create new projects using the BlazorForKids project template
• 📦 Sync and install framework packages locally
• 📄 Repair or replace corrupted license files
• 🔍 Check for the latest framework version
• 🧪 Run internal diagnostics and checks

🚀 Getting Started

To use bkcli, you must have a valid BlazorForKids license. You can register and obtain your API key at https://blazor-for-kids.com.

1. Install the Tool

dotnet tool install --global BlazorForKids.Tool

2. Register Your License

bkcli register --apikey <YOUR_API_KEY>

3. Create a New Project

dotnet new blazorforkids -n MyAwesomeApp

🧾 Available Commands

• bkcli reset – 🧹 Reset all bkcli settings and remove the local license file. Use this if you're starting over.
• bkcli register – 🔑 Register your license using an API key from your Blazor For Kids account.
• bkcli trycheck – 🔄 Check if your license is still valid. If offline, it skips errors. This runs automatically when opening solutions.
• bkcli check – ✅ Force-check your license with the server and refresh it if needed. Requires internet.
• bkcli update – 📦 Download and install the latest Blazor For Kids packages allowed by your license.
• bkcli upgrade – ⬆️ Upgrade your Blazor For Kids SDK version in the current solution.
• bkcli version – 📌 Show the current version of the bkcli tool.
• bkcli info – 📘 Show beginner-friendly info about what bkcli does and how to use it.
• bkcli copy-license – 🔒 Copy license file to Blazor for Kids projects (internal use only).
• bkcli repair-license – 🛠 Repairs the embedded license file. Use this only if the license file has been corrupted, deleted, or tampered with. After running this command, restart your IDE to reload the project correctly.

🛠 Repairing License File

If your project fails to build due to a corrupted or tampered license file, use the following command to automatically fix it:

bkcli repair-license

This command replaces the invalid license with a valid one (if eligible). Restart your IDE after repair.

🧑‍🏫 Learn More

📺 BlazorForKids YouTube Channel
📘 Get Started with the Framework

🧾 License & Legal

By using this tool, you agree to the License Agreement and the EULA.
Full legal documentation is available at https://blazor-for-kids.com.

❤️ Join the Community

We’re building a toolset for makers, learners, and professionals alike. Join us as we shape a framework that's approachable for everyone — and powerful enough for real-world apps.

🌐 blazor-for-kids.com