Ceamsys.SofiaComponents 1.0.10

Sofia Components

Sofia Components — Software & Inteligencia Artificial — is a comprehensive UI component library for Blazor WebAssembly and Blazor Web Apps (Server), built and maintained by Ceamsys.

📖 English · 📖 Español

🌐 Live examples / Ejemplos en vivo: See every component in action at https://sofia.ceamsys.com

English

About

Sofia Components provides 160+ production-ready UI components — buttons, forms, data grids, charts, dialogs, drawers, navigation, theming, and more — for building modern Blazor applications on both hosting models (WebAssembly and Server), sharing the same API and the same look and feel across both.

Sofia Components is developed and owned by the software company Ceamsys (https://ceamsys.com/), based in Guatemala, under the direction of its CEO, Systems Engineer José Rigoberto Alonso Hernández, with the goal of providing the most advanced Blazor component library for the advanced systems Ceamsys builds for its clients.

License

Sofia Components is free to use — including in commercial, corporate, and enterprise projects — under the Sofia Components Community License. See LICENSE.txt for the full terms. In short: build and ship whatever you want with it, at no cost; you just can't redistribute the library itself as a standalone product.

PRO Licensing

Advanced components require a separate Sofia PRO license, validated entirely offline (no network calls, in build-time or in production) using an RSA-PSS key pair. A new Release build with a present-but-invalid license fails to compile with a clear error; a missing license simply builds as Community. Once a build compiles successfully under a valid license, it keeps running in PRO forever — even after the license's calendar expiration — so a lapsed subscription only blocks new Release builds, never an already-deployed production app. Call builder.Services.AddSofiaLicense() to register the runtime check, and see the live /misc/license-status page (SofiaLicenseStatusDocs) for the current resolved status. See Sofia/Licensing/CONSUMER-INTEGRATION.md for the full setup guide, and Sofia/Licensing/LICENSE-CONTRACT.md for the technical contract.

Install

dotnet add package Ceamsys.SofiaComponents --version 1.0.2

or via the Package Manager Console:

Install-Package Ceamsys.SofiaComponents -Version 1.0.2

Quick setup

1. Import namespaces in _Imports.razor:

   @using Sofia.Components.Buttons
   @using Sofia.Components.Cards
   @using Sofia.Components.Dialogs
   @using Sofia.Components.DataGrid
   @using Sofia.Components.Inputs
   @using Sofia.Components.Layout
   @using Sofia.Components.Overlay
   @using Sofia.Components.Theming
   @using Sofia.Enum
   @using Sofia.Services.Dialogs
   @using Sofia.Services.Messages
   @using Sofia.Services.Overlay
   @using Sofia.Theming
   

2. Register services in Program.cs:

   builder.Services.AddSofiaTheme();
   builder.Services.AddSofiaDialogs();
   builder.Services.AddSofiaOverlayManager();
   builder.Services.AddSofiaToasts();
   

3. Link the stylesheet and script (one bundled file each — no need to reference dozens of individual files):

   <link href="_content/Sofia/Sofia.bundle.scp.css" rel="stylesheet" />
   <link href="_content/Sofia/sofia.css" rel="stylesheet" />
   <script src="_content/Sofia/sofia.js"></script>
   

4. Wrap your app in MainLayout.razor:

   <SofiaThemeProvider>
       <SofiaLayout ShowFooter="true">
   
       </SofiaLayout>
       <SofiaDialogProvider />
       <SofiaOverlayManagerHost />
       <SofiaToastHost />
   </SofiaThemeProvider>
   

5. Use a component:

   <SofiaButton Label="Click me" Severity="SofiaButtonSeverity.Primary" Clicked="OnClick" />
   

👉 Want to see the components before installing (or while building)? Browse live, interactive examples of every component at sofia.ceamsys.com.

For the full setup guide (WebAssembly vs. Blazor Web App differences) and the complete component catalog, see the Get Started page on that same site.

About Ceamsys

Ceamsys (https://ceamsys.com/) develops advanced software systems and is the company behind Sofia Components. The library was created by its CEO, Systems Engineer José Rigoberto Alonso Hernández, to give Ceamsys' own products the most advanced Blazor component library available — and to share that same foundation with the community.

Español

Acerca de

Sofia Components ofrece más de 160 componentes de interfaz listos para producción — botones, formularios, data grids, gráficos, diálogos, drawers, navegación, theming y más — para construir aplicaciones Blazor modernas en ambos modelos de hosting (WebAssembly y Server), compartiendo la misma API y la misma apariencia en los dos.

Sofia Components es desarrollado y es propiedad de la empresa de Software Ceamsys (https://ceamsys.com/) con cede en Guatemala, bajo la dirección de su CEO, el Ingeniero en Sistemas José Rigoberto Alonso Hernández, con el objetivo de contar con la librería de componentes Blazor más avanzada para los sistemas avanzados que desarrolla Ceamsys.

Licencia

Sofia Components es de uso libre — incluso en proyectos comerciales, corporativos y empresariales — bajo la Licencia Community de Sofia Components. Ver LICENSE.txt para los términos completos. En resumen: puedes construir y distribuir lo que quieras con ella, sin costo; solo no puedes redistribuir la librería en sí como producto independiente.

Licenciamiento PRO

Los componentes avanzados requieren una licencia Sofia PRO separada, validada totalmente offline (sin llamadas de red, ni en build-time ni en producción) con un par de claves RSA-PSS. Un build Release nuevo con una licencia presente pero inválida no compila (error claro); sin ninguna licencia, compila normalmente en tier Community. Una vez que un build compila con éxito bajo una licencia válida, sigue funcionando en PRO para siempre — aunque la licencia venza en el calendario después — así una suscripción vencida solo bloquea nuevos builds Release, nunca una app ya desplegada en producción. Llama a builder.Services.AddSofiaLicense() para registrar la validación en runtime, y consulta la página en vivo /misc/license-status (SofiaLicenseStatusDocs) para ver el estado resuelto actual. Ver Sofia/Licensing/CONSUMER-INTEGRATION.md para la guía completa de configuración, y Sofia/Licensing/LICENSE-CONTRACT.md para el contrato técnico.

Instalación

dotnet add package Ceamsys.SofiaComponents --version 1.0.2

o desde la Consola del Administrador de Paquetes:

Install-Package Ceamsys.SofiaComponents -Version 1.0.2

Configuración rápida

1. Importar namespaces en _Imports.razor:

   @using Sofia.Components.Buttons
   @using Sofia.Components.Cards
   @using Sofia.Components.Dialogs
   @using Sofia.Components.DataGrid
   @using Sofia.Components.Inputs
   @using Sofia.Components.Layout
   @using Sofia.Components.Overlay
   @using Sofia.Components.Theming
   @using Sofia.Enum
   @using Sofia.Services.Dialogs
   @using Sofia.Services.Messages
   @using Sofia.Services.Overlay
   @using Sofia.Theming
   

2. Registrar servicios en Program.cs:

   builder.Services.AddSofiaTheme();
   builder.Services.AddSofiaDialogs();
   builder.Services.AddSofiaOverlayManager();
   builder.Services.AddSofiaToasts();
   

3. Enlazar la hoja de estilos y el script (un solo archivo de cada uno, sin necesidad de referenciar decenas de archivos individuales):

   <link href="_content/Sofia/Sofia.bundle.scp.css" rel="stylesheet" />
   <link href="_content/Sofia/sofia.css" rel="stylesheet" />
   <script src="_content/Sofia/sofia.js"></script>
   

4. Envolver la app en MainLayout.razor:

   <SofiaThemeProvider>
       <SofiaLayout ShowFooter="true">
   
       </SofiaLayout>
       <SofiaDialogProvider />
       <SofiaOverlayManagerHost />
       <SofiaToastHost />
   </SofiaThemeProvider>
   

5. Usar un componente:

   <SofiaButton Label="Haz clic" Severity="SofiaButtonSeverity.Primary" Clicked="OnClick" />
   

👉 ¿Quieres ver los componentes antes de instalar (o mientras desarrollas)? Explora ejemplos interactivos de cada componente en sofia.ceamsys.com.

Para la guía de configuración completa (diferencias WebAssembly vs. Blazor Web App) y el catálogo completo de componentes, consulta la página Get Started en ese mismo sitio.

Acerca de Ceamsys

Ceamsys (https://ceamsys.com/) desarrolla sistemas de software avanzados y es la empresa detrás de Sofia Components. La librería fue creada por su CEO, el Ingeniero en Sistemas José Rigoberto Alonso Hernández, para dotar a los propios productos de Ceamsys de la librería de componentes Blazor más avanzada disponible — y para compartir esa misma base con la comunidad.