Skip to content
Open
Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
26 commits
Select commit Hold shift + click to select a range
25be7e2
docs: Add Umbraco 18 beta upgrade plan
claude May 18, 2026
68f5797
feat: Upgrade to Umbraco 18.0.0-beta2
claude May 18, 2026
66d3ae1
chore: Add SessionStart hook to install .NET 10 SDK
claude May 18, 2026
57f5e26
fix: Resolve Umbraco 18 build errors
claude May 18, 2026
0113e71
chore: Note why the session hook tracks .NET 10
claude May 18, 2026
3444a6a
Replace uSync with Clean.Blog package migration
claude May 18, 2026
f0f9bcb
Provision the Clean.Blog API client at startup
claude May 18, 2026
b64d784
Provision API client + run package migration before listener starts
claude May 18, 2026
206867c
Restore uSync for Clean.Blog content sync on Umbraco 18
prjseal Jun 12, 2026
8563c7f
Migrate uSync seed data to the v18 folder
prjseal Jun 12, 2026
f2941dc
Regenerate ModelsBuilder models for Umbraco 18
prjseal Jun 12, 2026
8f02caf
Remove BlockList label workaround and repoint package scripts to uSyn…
prjseal Jun 12, 2026
5370b54
Ignore the .claude directory and stop tracking its files
prjseal Jun 12, 2026
2339e78
Docs/delivery api setup (#462)
claude Jun 24, 2026
3da15ba
Restore BlockList label workaround for Umbraco issue #20801
claude Jun 24, 2026
073a411
Fix PowerShell syntax error in Fix-BlockListLabels function
claude Jun 24, 2026
1c577bd
Move Title, Subtitle and Main Image to Hero tab in uSync compositions
claude Jun 24, 2026
4169f8e
Fix Rich Text block list label not rendering in Umbraco 18
claude Jun 24, 2026
93066a7
Remove second backoffice element screenshot per content item in Playw…
claude Jun 24, 2026
a554af9
Fix Rich Text block label showing [object Object] in Umbraco 18
claude Jun 24, 2026
26e39ff
Show image count in Image Carousel block list label
claude Jun 24, 2026
6d2be3d
Diagnose Rich Text label and fix Image Carousel count display
claude Jun 24, 2026
23be153
Try content.content | stripHtml for Rich Text block list label
claude Jun 24, 2026
9209fcd
Diagnostic: show content.content raw (no filter) for Rich Text label
claude Jun 24, 2026
41801c7
got labels working again and changed to using element library for cat…
prjseal Jun 25, 2026
7b8afee
docs and versions update
prjseal Jun 25, 2026
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
The table of contents is too big for display.
Diff view
Diff view
  •  
  •  
  •  
172 changes: 0 additions & 172 deletions .github/clean-blocklist-workaround.md

This file was deleted.

10 changes: 0 additions & 10 deletions .github/clean-documentation.md
Original file line number Diff line number Diff line change
Expand Up @@ -98,16 +98,6 @@ Documentation related to GitHub Actions workflows and automation:

---

## Technical References

Technical documentation for specific issues and workarounds:

### BlockList Label Workaround

- **[BlockList Label Workaround](clean-blocklist-workaround.md)** - Documentation for the temporary workaround for Umbraco BlockList label export issue (#20801)

---

## Additional Resources

### External Resources
Expand Down
13 changes: 13 additions & 0 deletions .github/clean-headless-api.md
Original file line number Diff line number Diff line change
Expand Up @@ -16,6 +16,19 @@ The Clean starter kit includes full support for headless implementations. To ena
}
```

Update your `program.cs`:

```csharp
builder.CreateUmbracoBuilder()
.AddBackOffice()
.AddWebsite()
.AddDeliveryApi()
.AddComposers()
.Build();
```

Once the Content Delivery API is enabled, the next step is to rebuild the Delivery API content index **DeliveryApiContentIndex**. This can be done using the Examine Management dashboard in the Settings section of the Umbraco Backoffice.

## Next.js Revalidation

To enable automatic revalidation of content in Next.js applications, configure the following in your `appsettings.json`:
Expand Down
27 changes: 13 additions & 14 deletions .github/general-contributing.md
Original file line number Diff line number Diff line change
Expand Up @@ -88,20 +88,18 @@ This means:
The uSync configuration files are located in:
```
template/Clean.Blog/uSync/
├── v16/ # Umbraco 16 configuration
├── v17/ # Umbraco 17 configuration
│ ├── Content/ # Content nodes
│ ├── ContentTypes/ # Document Types
│ ├── DataTypes/ # Data Type definitions
│ ├── Dictionary/ # Dictionary items for translations
│ ├── Languages/ # Language configurations
│ ├── Media/ # Media items
│ ├── MediaTypes/ # Media Type definitions
│ ├── MemberTypes/ # Member Type definitions
│ ├── RelationTypes/ # Relation Type definitions
│ ├── Templates/ # Razor templates
│ └── usync.config # uSync version metadata
└── v17-backup/ # Backup configuration
└── v18/ # Umbraco 18 configuration
├── Content/ # Content nodes
├── ContentTypes/ # Document Types
├── DataTypes/ # Data Type definitions
├── Dictionary/ # Dictionary items for translations
├── Languages/ # Language configurations
├── Media/ # Media items
├── MediaTypes/ # Media Type definitions
├── MemberTypes/ # Member Type definitions
├── RelationTypes/ # Relation Type definitions
├── Templates/ # Razor templates
└── usync.config # uSync version metadata
```

## Database Changes and uSync
Expand Down Expand Up @@ -382,6 +380,7 @@ The Clean Starter Kit supports multiple versions of Umbraco:
| 5.x | 15 | .NET 9 | STS |
| 6.x | 16 | .NET 9 | STS |
| 7.x | 17 | .NET 10 | LTS |
| 8.x | 18 | .NET 10 | STS |

When contributing:
- **Target the appropriate version** for your changes
Expand Down
21 changes: 5 additions & 16 deletions .github/script-create-nuget-packages.md
Original file line number Diff line number Diff line change
Expand Up @@ -2,15 +2,15 @@

## Overview

This comprehensive script creates NuGet packages by starting Umbraco, downloading the package via API, applying BlockList label fixes (temporary workaround), updating .csproj versions, and building all packages in dependency order.
This comprehensive script creates NuGet packages by starting Umbraco, downloading the package via API, updating .csproj versions, and building all packages in dependency order.

## Script Location

`.github/workflows/powershell/CreateNuGetPackages.ps1`

## Purpose

Orchestrates the entire package creation process including running Umbraco, downloading content package, fixing BlockList labels, updating versions, and building all NuGet packages.
Orchestrates the entire package creation process including running Umbraco, downloading content package, updating versions, and building all NuGet packages.

## When It's Used

Expand All @@ -30,20 +30,11 @@ Orchestrates the entire package creation process including running Umbraco, down
4. **Starts Umbraco** - Runs Clean.Blog project
5. **Waits for API** - Polls until Umbraco responds
6. **Downloads Package** - Gets package.zip via API
7. **Fixes BlockList Labels** - Applies workaround for Umbraco issue #20801
8. **Updates Versions** - Sets version in all .csproj files
9. **Builds Packages** - In dependency order: Core → Headless → Clean → Template
7. **Updates Versions** - Sets version in all .csproj files
8. **Builds Packages** - In dependency order: Core → Headless → Clean → Template

## Key Features

### BlockList Label Fix (Temporary)

Workaround for [Umbraco issue #20801](https://github.com/umbraco/Umbraco-CMS/issues/20801):
- Extracts package.zip
- Reads BlockList config from uSync
- Adds labels to package.xml
- Repacks package.zip

### Dependency Order Building

1. **Clean.Core** - Base package
Expand Down Expand Up @@ -86,12 +77,10 @@ Packages created in `.artifacts/nuget/`:
## Related Documentation

- [workflow-versioning-releases.md](workflow-versioning-releases.md) - Parent workflow
- BlockList issue: https://github.com/umbraco/Umbraco-CMS/issues/20801

## Notes

- **Most complex script** in the workflow (831 lines)
- **Temporary BlockList fix** - remove when Umbraco fixes issue
- **Most complex script** in the workflow
- **Builds in dependency order** to avoid package resolution errors
- **Uses local NuGet source** for intermediate packages
- **Supports both PowerShell 5.x and Core 6+**
Loading
Loading