Overview
Free apps
The free apps are three complete applications built on WUIC and distributed for free from the Download page of the site: FatturazioneElettronica (Italian electronic invoicing with SDI), CrmApp (B2B CRM) and FlottaMezzi (fleet management). They run on Windows with SQL Server: other databases are not supported.
Free binary or sources with a license
Every version of a free app ships as two zips:
| Zip | Content | WUIC license |
|---|---|---|
<App>-iis-v<version>-with-dbs.zip | the application already compiled (publish folder for IIS), the two backups db/data.bak and db/metadata.bak, INSTALL.md | not needed: the binary carries a host binding license that authorizes the framework only for that application as distributed |
<App>-src-v<version>.zip | the application sources (C#, Angular client, reports, configuration), the same two backups, INSTALL-src.md | needed to run the recompiled application |
Whoever recompiles loses the host binding license: the key that signs the assembly is not in the zip, so the binary produced falls back to the normal license check with the machine fingerprint. You need a WUIC license that covers SQL Server (Launch price or Enterprise tier; the Standard tier covers only MySQL and PostgreSQL). Without a license the application runs in Trial mode (at most 20 records per query). Prices: wuic-framework.com/pricing.
The sources zip does not carry the framework as code: the csproj uses the NuGet package WuicCore and wwwroot/package.json the npm package wuic-framework-lib, both at the exact version the free app was released with.
Installing the binary
INSTALL.md inside the -iis- zip describes the steps: restore of the two backups, SQL user, IIS site and connection strings in appsettings.json. No license and no compilation are needed.
Installing the sources
On a Windows development machine, from PowerShell:
& ([scriptblock]::Create((irm https://wuic-framework.com/install.ps1))) -Src -App FatturazioneElettronica(-App CrmApp or -App FlottaMezzi for the other two). The script:
1. installs with winget whatever is missing among .NET SDK 10, Node.js LTS, SQL Server Express and git;
2. downloads the sources zip of the current version from the site feed (/downloads/releases.json, section freeapps) and checks its SHA-256;
3. extracts it into C:\dev\<App> (-InstallDir for another folder);
4. creates a git repository with the branch vendor/<app> (the vendor sources as they are) and the working branch main created from it;
5. restores the two databases from the backups and writes the connection strings (Windows authentication) in appsettings.json and appsettings.Development.json;
6. runs dotnet restore and npm install.
With the zip already downloaded: -PackageUrl <path of the zip> (in that case there is no SHA-256 from the feed to compare it with). INSTALL-src.md in the zip lists the same steps to do by hand.
The sources zip has the same layout as the framework one:
| File | What it is for |
|---|---|
<App>.code-workspace, .vscode/launch.json, .vscode/tasks.json | open the project in VS Code and start backend and client with F5 (Fullstack: <App> + Chrome) |
llm-workspace/, AGENTS.md | curated skills, templates and the WUIC Assistant plugin; AGENTS.md has a Project-specific section with the tables, routes, data DB objects and traps of the app |
scripts/wuic-meta.ps1 | command line of the metadata lifecycle |
wuic-app.json | manifest of the version: key, version, framework, lifecycle release, SHA-256 of every vendor file |
First login
The databases of the free apps come with the administrator user admin, password admin. The credentials are public: change the password at the first login (menu Change password) and change or disable the demo users before entering real data.
For the sources, the license is applied as for the framework (page Licensing): machineFingerprint from GET /api/Meta/LicenseStatus, then license-payload and license-signature in Administration > AppSettings Editor, section License.
How to customize
- Metadata (routes, columns, menus, templates, permissions, workflows, dashboards): from the application, with the designers and the Editor, as in every WUIC app. The metadata backup contains the lifecycle release registered by the vendor (
fe-<version>,crm-<version>,flotta-<version>): it is the base against which the App lifecycle page andscripts/wuic-meta.ps1compare the state of the installation (page Metadata lifecycle). - Reports: the files
Reports/<route>/*.mrt, editable with the Report designer. - Code (C# controllers and services, Angular components in
wwwroot/src): only from the sources zip, with the license described above.
The vendor branch
install.ps1 -Src -App creates the repository with two branches: vendor/<app> holds the vendor sources without changes, main is the branch you work on. Keep vendor/<app> untouched: it is the common base between your version and the vendor's. The .gitignore of the zip keeps bin, obj, node_modules and the .bak backups out of the repository.
Updating
The binary FatturazioneElettronica (-iis- zip) is upgraded from 1.7.28 to 1.8.0 with the upgrade\ folder of the new zip, keeping data and customizations: the procedure is on the page Upgrading a free app. Do not extract the new zip over the installation and do not restore its backups: they are for a new installation.
For CrmApp and FlottaMezzi, and for whoever installed the sources, there is no procedure yet. In the meantime: do not change the vendor/<app> branch, keep the zip of the installed version and leave the vendor release in the metadata database. wuic-app.json lists the SHA-256 of every vendor file of the installed version.