diff --git a/BlazorOpenApi/BlazorOpenApi.csproj b/BlazorOpenApi/BlazorOpenApi.csproj
index 435f2fb..02b9ace 100644
--- a/BlazorOpenApi/BlazorOpenApi.csproj
+++ b/BlazorOpenApi/BlazorOpenApi.csproj
@@ -1,14 +1,15 @@
 <Project Sdk="Microsoft.NET.Sdk.Razor">
   <PropertyGroup>
         <IsPackable>true</IsPackable>
-		<Authors>Alexander Shabarshov</Authors>
-		<Description>
-			OpenAPI documentation generator for Blazor applications.
-		</Description>
-		<PackageProjectUrl>https://github.com/unclshura/BlazorOpenApi</PackageProjectUrl>
-		<PackageTags>openapi, c#, blazor, api, ui, rest, web</PackageTags>
+        <Authors>Alexander Shabarshov</Authors>
+        <Description>
+            OpenAPI documentation generator for Blazor applications.
+        </Description>
+        <PackageProjectUrl>https://github.com/unclshura/BlazorOpenApi</PackageProjectUrl>
+        <PackageTags>openapi, c#, blazor, api, ui, rest, web</PackageTags>
+        <PackageReadmeFile>README.md</PackageReadmeFile>
   </PropertyGroup>
-	
+    
   <ItemGroup>
     <FrameworkReference Include="Microsoft.AspNetCore.App" />
     <PackageReference Include="Markdig" />
diff --git a/BlazorOpenApi/README.md b/BlazorOpenApi/README.md
index cbc66d5..b5bffd1 100644
--- a/BlazorOpenApi/README.md
+++ b/BlazorOpenApi/README.md
@@ -1,3 +1,70 @@
 # Blazor OpenAPI UI
 
-Blazor implementation of SwaggerUI-like interface.
+Author: *unclshura*
+
+This is a Blazor implementation of a SwaggerUI-like interface. It allows you to view your OpenAPI 
+specifications in a user-friendly way. The motication of this project is to provide a Blazor component that can be used in Blazor applications 
+to display OpenAPI specifications. Unlike SwaggerUI, this project does not require any JavaScript dependencies. 
+It is a pure Blazor implementation.
+
+## Installation
+
+You can install the package from NuGet:
+```bash
+dotnet add package BlazorOpenApi
+```
+
+Source code:
+```bash
+Github: https://github.com/unclshura/BlazorOpenApi
+HTTPS: https://github.com/unclshura/BlazorOpenApi.git
+SSH: git@github.com:unclshura/BlazorOpenApi.git
+```
+
+## Features
+
+- View OpenAPI specifications in a user-friendly way
+- Dark and light themes
+- Fully customizable color palette
+- Separate CSS styles for every element
+- Examples generation
+- Pure Blazor implementation
+
+## Usage
+
+To use the component, add the following line to your `_Imports.razor` file:
+```razor
+@using BlazorOpenApi
+@using BlazorOpenApi.Controls
+```
+Then, you can use the component in your Blazor application:
+```razor
+<OpenAPIUIControl Url="https://raw.githubusercontent.com/OAI/OpenAPI-Specification/main/examples/v3.0/petstore.yaml" />
+```
+
+To customize the palette you can use something like this:
+```razor
+<OpenAPIUIControl Url="@Url" Palette="@TestPalette"/>
+
+@code {
+    [Parameter]
+    [SupplyParameterFromQuery(Name = "url")]
+    public string Url { get; set; } = "https://raw.githubusercontent.com/OAI/OpenAPI-Specification/main/examples/v3.0/petstore.json";
+
+    private OpenApiUiPalette TestPalette
+    {
+        get
+        {
+            var p = new OpenApiUiPalette().Clone();
+            p.Foreground[7] = "blue";
+
+            return p;
+        }
+    }
+}
+```
+
+The demo application is available in the `Demo` folder - https://github.com/unclshura/BlazorOpenApi/tree/master/Demo. 
+
+# LICENSE
+MIT
\ No newline at end of file