webexpress-framework · ReneSchwarzer · Sep 1, 2025 · Apr 19, 2025 · Apr 19, 2025 · Apr 20, 2025
diff --git a/.gitignore b/.gitignore
@@ -51,4 +51,7 @@ CodeCoverage/
 # NUnit
 *.VisualState.xml
 TestResult.xml
-nunit-*.xml
+nunit-*.xml
+/.vs
+/src/.vs/WebExpress.Tutorial.WebUI
+/src/.vs/ProjectEvaluation
diff --git a/PrivacyPolicy.md b/PrivacyPolicy.md
@@ -0,0 +1,2 @@
+# Privacy policy
+The data entered during use is stored locally on your device. You retain data sovereignty at all times. The data will not be transmitted to third parties at any time. Personal information and location information is not collected.
diff --git a/README.md b/README.md
@@ -1,2 +1,55 @@
-# WebExpress.Tutorial.WebUI
-A tutorial demonstrating the UI elements of a WebExpress application.
+![WebExpress](https://raw.githubusercontent.com/ReneSchwarzer/WebExpress/main/assets/banner.png)
+
+# WebExpress
+`WebExpress` is a lightweight web server optimized for use in low-performance environments (e.g. Rasperry PI). By providing a powerful plugin system and a comprehensive API, web applications can be easily and quickly integrated into a .net language (e.g. C#). Some advantages of `WebExpress` are:
+
+- It is easy to use.
+- It offers a variety of features and tools that can help you build and manage your website.
+- It is fast and efficient and can help you save time and money.
+- It is flexible and can be customized to meet your specific requirements.
+
+The `WebExpress` family includes the following projects:
+
+- [WebExpress](https://github.com/ReneSchwarzer/WebExpress#readme) - The web server for `WebExpress` applications and the documentation.
+- [WebExpress.WebCore](https://github.com/ReneSchwarzer/WebExpress.WebCore#readme) - The core for `WebExpress` applications.
+- [WebExpress.WebUI](https://github.com/ReneSchwarzer/WebExpress.WebUI#readme) - Common templates and controls for `WebExpress` applications.
+- [WebExpress.WebIndex](https://github.com/ReneSchwarzer/WebExpress.WebIndex#readme) - Reverse index for `WebExpress` applications.
+- [WebExpress.WebApp](https://github.com/ReneSchwarzer/WebExpress.WebApp#readme) - Business application template for `WebExpress` applications.
+
+`WebExpress` is part of the `WebExpress` family. The project provides a web server for `WebExpress` applications.
+
+To get started with `WebExpress`, use the following links.
+
+- [installation guide](https://github.com/ReneSchwarzer/WebExpress/blob/main/doc/installation_guide.md) 
+- [development guide](https://github.com/ReneSchwarzer/WebExpress/blob/main/doc/development_guide.md)
+
+# Tutorial
+This tutorial guides you through demonstrating the UI elements of a `WebExpress` application. Learn how to effectively use the templates and controls provided by the `WebExpress.WebUI` project.
+
+## Prerequisites
+- Create a `WebExpress` application after the [WebApp](https://github.com/ReneSchwarzer/WebExpress.Tutorial.WebApp#readme) tutorial but name it `WebExpress.Tutorial.WebUI`.
+
+## Compile and register in WebExpress
+- Compile the solution as a release. To do this, open the command line or terminal in the solution directory and run the following command:
+  ```bash
+  dotnet build --configuration Release
+  ```
+  This command compiles the solution in release mode. You can find the compiled files in the `bin/Release` directory of your project.
+
+- Run the solution by starting the `WebApp.App` project.
+  ```bash
+  cd WebApp.App\bin\Release\net9.0
+  dotnet run --project ../../../WebApp.App.csproj
+  ```
+
+- After compiling, there should be a file with the `.wxp` extension in the `pkg/Release` directory. This file do you need in `WebExpress`.
+
+## Try the application
+- Check the result by calling up the following URL in the browser: http://localhost/webui
+
+Good luck building stunning web applications with `WebExpress`!
+
+# Tags
+#WebExpress #WebServer #WebCore #WebUI #Tutorial #DotNet
+
+
diff --git a/WebExpress.Tutorial.WebUI.spec b/WebExpress.Tutorial.WebUI.spec
@@ -0,0 +1,14 @@
+<?xml version="1.0" encoding="utf-8"?>
+<package>
+    <id>WebExpress.Tutorial.WebUI</id>
+    <version>0.0.9-alpha</version>
+    <title>WebApp</title>
+    <authors>rene_schwarzer@hotmail.de</authors>
+    <license>MIT</license>
+    <icon>icon.png</icon>
+    <readme>README.md</readme>
+    <privacypolicy>PrivacyPolicy.md</privacypolicy>
+    <description>A tutorial demonstrating the UI elements of a WebExpress application.</description>
+    <tags>webexpress tutorial</tags>
+    <plugin>WebUI</plugin>
+</package>
diff --git a/src/WebExpress.Tutorial.WebUI.sln b/src/WebExpress.Tutorial.WebUI.sln
@@ -0,0 +1,51 @@
+
+Microsoft Visual Studio Solution File, Format Version 12.00
+# Visual Studio Version 17
+VisualStudioVersion = 17.0.31903.59
+MinimumVisualStudioVersion = 10.0.40219.1
+Project("{FAE04EC0-301F-11D3-BF4B-00C04F79EFBC}") = "WebUI.App", "WebUI.App\WebExpress.Tutorial.WebUI.App.csproj", "{9EF6A7CC-2443-45FB-BF3A-83DAED128848}"
+EndProject
+Project("{FAE04EC0-301F-11D3-BF4B-00C04F79EFBC}") = "WebUI", "WebUI\WebExpress.Tutorial.WebUI.csproj", "{63546686-B3B3-4859-9186-8F9D0B07DE49}"
+EndProject
+Global
+	GlobalSection(SolutionConfigurationPlatforms) = preSolution
+		Debug|Any CPU = Debug|Any CPU
+		Debug|x64 = Debug|x64
+		Debug|x86 = Debug|x86
+		Release|Any CPU = Release|Any CPU
+		Release|x64 = Release|x64
+		Release|x86 = Release|x86
+	EndGlobalSection
+	GlobalSection(ProjectConfigurationPlatforms) = postSolution
+		{9EF6A7CC-2443-45FB-BF3A-83DAED128848}.Debug|Any CPU.ActiveCfg = Debug|Any CPU
+		{9EF6A7CC-2443-45FB-BF3A-83DAED128848}.Debug|Any CPU.Build.0 = Debug|Any CPU
+		{9EF6A7CC-2443-45FB-BF3A-83DAED128848}.Debug|x64.ActiveCfg = Debug|Any CPU
+		{9EF6A7CC-2443-45FB-BF3A-83DAED128848}.Debug|x64.Build.0 = Debug|Any CPU
+		{9EF6A7CC-2443-45FB-BF3A-83DAED128848}.Debug|x86.ActiveCfg = Debug|Any CPU
+		{9EF6A7CC-2443-45FB-BF3A-83DAED128848}.Debug|x86.Build.0 = Debug|Any CPU
+		{9EF6A7CC-2443-45FB-BF3A-83DAED128848}.Release|Any CPU.ActiveCfg = Release|Any CPU
+		{9EF6A7CC-2443-45FB-BF3A-83DAED128848}.Release|Any CPU.Build.0 = Release|Any CPU
+		{9EF6A7CC-2443-45FB-BF3A-83DAED128848}.Release|x64.ActiveCfg = Release|Any CPU
+		{9EF6A7CC-2443-45FB-BF3A-83DAED128848}.Release|x64.Build.0 = Release|Any CPU
+		{9EF6A7CC-2443-45FB-BF3A-83DAED128848}.Release|x86.ActiveCfg = Release|Any CPU
+		{9EF6A7CC-2443-45FB-BF3A-83DAED128848}.Release|x86.Build.0 = Release|Any CPU
+		{63546686-B3B3-4859-9186-8F9D0B07DE49}.Debug|Any CPU.ActiveCfg = Debug|Any CPU
+		{63546686-B3B3-4859-9186-8F9D0B07DE49}.Debug|Any CPU.Build.0 = Debug|Any CPU
+		{63546686-B3B3-4859-9186-8F9D0B07DE49}.Debug|x64.ActiveCfg = Debug|Any CPU
+		{63546686-B3B3-4859-9186-8F9D0B07DE49}.Debug|x64.Build.0 = Debug|Any CPU
+		{63546686-B3B3-4859-9186-8F9D0B07DE49}.Debug|x86.ActiveCfg = Debug|Any CPU
+		{63546686-B3B3-4859-9186-8F9D0B07DE49}.Debug|x86.Build.0 = Debug|Any CPU
+		{63546686-B3B3-4859-9186-8F9D0B07DE49}.Release|Any CPU.ActiveCfg = Release|Any CPU
+		{63546686-B3B3-4859-9186-8F9D0B07DE49}.Release|Any CPU.Build.0 = Release|Any CPU
+		{63546686-B3B3-4859-9186-8F9D0B07DE49}.Release|x64.ActiveCfg = Release|Any CPU
+		{63546686-B3B3-4859-9186-8F9D0B07DE49}.Release|x64.Build.0 = Release|Any CPU
+		{63546686-B3B3-4859-9186-8F9D0B07DE49}.Release|x86.ActiveCfg = Release|Any CPU
+		{63546686-B3B3-4859-9186-8F9D0B07DE49}.Release|x86.Build.0 = Release|Any CPU
+	EndGlobalSection
+	GlobalSection(SolutionProperties) = preSolution
+		HideSolutionNode = FALSE
+	EndGlobalSection
+	GlobalSection(ExtensibilityGlobals) = postSolution
+		SolutionGuid = {F33E197F-836F-4941-9DD1-D022DDE03DDE}
+	EndGlobalSection
+EndGlobal
diff --git a/src/WebUI.App/Program.cs b/src/WebUI.App/Program.cs
@@ -0,0 +1,17 @@
+using System.Reflection;
+
+namespace WebUI.App
+{
+    internal class Program
+    {
+        static void Main(string[] args)
+        {
+            var app = new WebExpress.WebCore.WebEx()
+            {
+                Name = Assembly.GetExecutingAssembly().GetName().Name
+            };
+
+            app.Execution(args);
+        }
+    }
+}
diff --git a/src/WebUI.App/WebExpress.Tutorial.WebUI.App.csproj b/src/WebUI.App/WebExpress.Tutorial.WebUI.App.csproj
@@ -0,0 +1,32 @@
+<Project Sdk="Microsoft.NET.Sdk">
+
+	<PropertyGroup>
+		<OutputType>Exe</OutputType>
+		<TargetFramework>net9.0</TargetFramework>
+		<ImplicitUsings>enable</ImplicitUsings>
+		<Nullable>enable</Nullable>
+	</PropertyGroup>
+
+	<ItemGroup>
+	  <None Remove="config\webexpress.config.xml" />
+	</ItemGroup>
+
+	<ItemGroup>
+		<PackageReference Include="WebExpress.WebApp" Version="0.0.9-alpha" />
+	</ItemGroup>
+
+	<ItemGroup>
+		<ProjectReference Include="../WebUI/WebExpress.Tutorial.WebUI.csproj" />
+	</ItemGroup>
+
+	<ItemGroup>
+	  <Content Include="config\webexpress.config.xml">
+	    <CopyToOutputDirectory>PreserveNewest</CopyToOutputDirectory>
+	  </Content>
+	</ItemGroup>
+
+	<Target Name="PostBuild" AfterTargets="PostBuildEvent" Condition="'$(Configuration)' == 'Release'">
+		<Exec Command="$(SolutionDir)$(AssemblyName)/bin/$(Configuration)/$(TargetFramework)/$(AssemblyName).exe -s $(SolutionDir)/$(SolutionName).spec -c $(Configuration) -t $(TargetFramework) -o $(SolutionDir)/pkg/$(Configuration)" />
+	</Target>
+
+</Project>
diff --git a/src/WebUI.App/config/webexpress.config.xml b/src/WebUI.App/config/webexpress.config.xml
@@ -0,0 +1,15 @@
+<?xml version="1.0" encoding="utf-8" ?>
+<config version = "1">
+	<log modus="Off" debug="false" path="/var/log/" encoding="utf-8" filename="webexpress.log" timepattern="dd.MM.yyyy HH:mm:ss" />
+	<uri>http://localhost/</uri>
+	<endpoint uri="http://localhost/"/>
+	<limit>
+		<connectionlimit>300</connectionlimit>
+		<uploadlimit>3000000000</uploadlimit>
+	</limit>
+	<culture>en</culture>
+	<packages>./packages</packages>
+	<assets>./assets</assets>
+	<data>./data</data>
+	<contextpath></contextpath>
+</config>
diff --git a/src/WebUI/Application.cs b/src/WebUI/Application.cs
@@ -0,0 +1,29 @@
+using WebExpress.WebCore.WebApplication;
+using WebExpress.WebCore.WebAttribute;
+
+namespace WebExpress.Tutorial.WebUI
+{
+    /// <summary>
+    /// Represents the application of the tutorial.
+    /// </summary>
+    [Name("webexpress.Tutorial.webui:app.name")]
+    [Description("webexpress.Tutorial.webui:app.description")]
+    [Icon("/assets/img/webui.svg")]
+    [ContextPath("/webui")]
+    public sealed class Application : IApplication
+    {
+        /// <summary>
+        /// Initializes a new instance of the class.
+        /// </summary>
+        public Application()
+        {
+        }
+
+        /// <summary>
+        /// Called when the application starts working. The call is concurrent. 
+        /// </summary>
+        public void Run()
+        {
+        }
+    }
+}
diff --git a/src/WebUI/Assets/img/carousel1.png b/src/WebUI/Assets/img/carousel1.png
diff --git a/src/WebUI/Assets/img/carousel2.png b/src/WebUI/Assets/img/carousel2.png
diff --git a/src/WebUI/Assets/img/carousel3.png b/src/WebUI/Assets/img/carousel3.png
diff --git a/src/WebUI/Assets/img/carousel4.png b/src/WebUI/Assets/img/carousel4.png
diff --git a/src/WebUI/Assets/img/carousel5.png b/src/WebUI/Assets/img/carousel5.png
diff --git a/src/WebUI/Assets/img/carousel6.png b/src/WebUI/Assets/img/carousel6.png
diff --git a/src/WebUI/Assets/img/favicon.png b/src/WebUI/Assets/img/favicon.png
diff --git a/src/WebUI/Assets/img/image1.png b/src/WebUI/Assets/img/image1.png
diff --git a/src/WebUI/Assets/img/image2.png b/src/WebUI/Assets/img/image2.png
diff --git a/src/WebUI/Assets/img/image3.png b/src/WebUI/Assets/img/image3.png
diff --git a/src/WebUI/Assets/img/rocket.png b/src/WebUI/Assets/img/rocket.png
diff --git a/src/WebUI/Assets/img/webui.svg b/src/WebUI/Assets/img/webui.svg
Original file line number	Diff line number	Diff line change
		@@ -0,0 +1,2 @@
		# Privacy policy
		The data entered during use is stored locally on your device. You retain data sovereignty at all times. The data will not be transmitted to third parties at any time. Personal information and location information is not collected.