diff --git a/IdentityShroud.sln b/IdentityShroud.sln
index ce316d1..b22cf9c 100644
--- a/IdentityShroud.sln
+++ b/IdentityShroud.sln
@@ -7,6 +7,9 @@ EndProject
 Project("{FAE04EC0-301F-11D3-BF4B-00C04F79EFBC}") = "IdentityShroud.Core.Tests", "IdentityShroud.Core.Tests\IdentityShroud.Core.Tests.csproj", "{DC887623-8680-4D3B-B23A-D54F7DA91891}"
 EndProject
 Project("{2150E333-8FDC-42A3-9474-1A3956D46DE8}") = "Solution Items", "Solution Items", "{576359FF-C672-4CC3-A683-3BB9D647E75D}"
+	ProjectSection(SolutionItems) = preProject
+		README.md = README.md
+	EndProjectSection
 EndProject
 Project("{FAE04EC0-301F-11D3-BF4B-00C04F79EFBC}") = "IdentityShroud.Migrations", "IdentityShroud.Migrations\IdentityShroud.Migrations.csproj", "{DEECABE3-8934-4696-B0E1-48738DD0CEC4}"
 EndProject
diff --git a/README.md b/README.md
index 8bd5aa3..f4d3cc9 100644
--- a/README.md
+++ b/README.md
@@ -2,3 +2,28 @@
 
 IdentityShroud is a .NET project for identity management and protection.
 
+# Architecture
+
+## App
+
+Projects combining all into a working app
+
+## Api
+
+Supplies Api that can be wired up in a project to get all the required endpoints
+
+## Core
+
+Should provide the OIDC functionality with little external dependencies.
+
+## Infra.*
+
+Multiple sub projectes.
+Provides implementations of the services that core requires. But these can be swapped for custom implementations.
+
+## Infra.EfCore
+
+Implementation of services that use an EF core context.
+
+
+