# HCI-SunBird

> HCI's lightweight CMS for hand-built ASP.NET Core Razor sites, shipped as NuGet packages. Developers and agents build pages by hand; editors change named slots (text, rich text, images) over a live preview.

The whole of these docs as one Markdown file: https://sunbird-doc.hciyork.co.uk/llms-full.txt

## Docs

- [HCI-SunBird](https://sunbird-doc.hciyork.co.uk/index.html): What SunBird is, who it is for, and how these docs are organised.
- [Getting started](https://sunbird-doc.hciyork.co.uk/getting-started.html): Add SunBird to an ASP.NET Core Razor Pages site and put the first editable slot on a page.
- [Pages and slots](https://sunbird-doc.hciyork.co.uk/concepts/pages-and-slots.html): How a page is identified, what slots are, and where their default content comes from.
- [Drafts and history](https://sunbird-doc.hciyork.co.uk/concepts/drafts-and-history.html): How saving, drafts, publishing and rollback work, and why history only grows.
- [Media library](https://sunbird-doc.hciyork.co.uk/concepts/media-library.html): How images and PDF documents are uploaded, reused, referenced by image slots, file slots and the share image, deleted, and stored.
- [SEO page settings](https://sunbird-doc.hciyork.co.uk/concepts/seo.html): The editable SEO settings of a page (title and meta description), their defaults in code, how sb-seo renders them with a canonical link, Open Graph and Twitter card tags, and what stays in the page markup.
- [Staging mode](https://sunbird-doc.hciyork.co.uk/concepts/staging.html): How a staging slot shares the live database safely with SunBird:Mode=Staging, what editors can and cannot do there, and the release workflow for new content.
- [How-to guides](https://sunbird-doc.hciyork.co.uk/how-to/index.html): Step-by-step recipes for common SunBird tasks, added as each feature is released.
- [Make a page editable](https://sunbird-doc.hciyork.co.uk/how-to/make-a-page-editable.html): Give a Razor page a key with [SunBirdPage], mark its editable parts with sb-text, sb-html, sb-image, sb-link, sb-file, sb-icon and sb-table, and reuse partials with sb-scope.
- [Edit a page](https://sunbird-doc.hciyork.co.uk/how-to/edit-a-page.html): How a signed-in editor changes a page's text, rich text and images on the live site in edit mode, saves a draft or publishes, previews and restores earlier versions from the history rail, and what the site needs for it.
- [Repeat parts of a page](https://sunbird-doc.hciyork.co.uk/how-to/repeat-parts-of-a-page.html): Wrap markup in sb-repeater so editors can add, remove and reorder entries, such as gallery pictures or testimonials, each with its own slots.
- [Share content between pages](https://sunbird-doc.hciyork.co.uk/how-to/share-content-between-pages.html): Make a partial view a fragment with [SunBirdFragment] and show it with sb-fragment, so editors change shared content, such as testimonials or a footer, once for every page that shows it.
- [Schedule publishing](https://sunbird-doc.hciyork.co.uk/how-to/schedule-publishing.html): Set a date and time for a page's or fragment's changes to go live, see and cancel a schedule, and how a scheduled version goes live without a background job.
- [Let editors add pages](https://sunbird-doc.hciyork.co.uk/how-to/create-pages-from-templates.html): Build a template with [SunBirdTemplate], allow it under a page with ChildTemplates, and list the pages editors add with sb-sub-pages or ISunBirdPages. Editors add pages from the edit bar, under the page they are on.
- [Sign in and manage editors](https://sunbird-doc.hciyork.co.uk/how-to/sign-in-and-manage-editors.html): Set up email for SunBird, create the first admin with a setup code, invite editors by email, let them reset forgotten passwords and change their email, and suspend or reactivate accounts.
- [Let agents edit content over MCP](https://sunbird-doc.hciyork.co.uk/how-to/let-agents-edit-content.html): Turn on SunBird's MCP server, give an AI agent an access token for an editor account, and use its tools to add pages from templates, fill in slots and fragments, upload images, save drafts, publish, schedule, roll back, unpublish and delete, following the same rules as edit mode.
- [Store images](https://sunbird-doc.hciyork.co.uk/how-to/store-images.html): Register an HCI.FileStorage IFileStorageService so SunBird can keep the images editors upload, set the upload size limit, and how SunBird serves images safely at /sunbird/media/{id}.
- [Store content in SQL Server](https://sunbird-doc.hciyork.co.uk/how-to/store-content-in-sql-server.html): Connect SunBird to a SQL Server or Azure SQL database with UseSqlServer, and let MapSunBird create and migrate its tables at startup.
- [Store content in SQLite](https://sunbird-doc.hciyork.co.uk/how-to/store-content-in-sqlite.html): Keep SunBird's content in a SQLite database file with UseSqlite, for sites with no database server, and let MapSunBird create and migrate its tables at startup.
- [Settings](https://sunbird-doc.hciyork.co.uk/settings.html): SunBird's settings in the SunBird configuration section, such as ShowSlotErrors, the first-user setup code, email sending and branding, the editor password and lockout rules, the image upload limit and the MCP server for agents, and how to set them for development, staging and the live site.
- [API reference](https://sunbird-doc.hciyork.co.uk/api/index.html): Every public type and member of the SunBird packages, generated from the code's XML documentation.
- [Class SunBirdSqlServerExtensions](https://sunbird-doc.hciyork.co.uk/api/HCI.SunBird.Data.SqlServer.SunBirdSqlServerExtensions.html): API reference for Class SunBirdSqlServerExtensions.
- [Namespace HCI.SunBird.Data.SqlServer](https://sunbird-doc.hciyork.co.uk/api/HCI.SunBird.Data.SqlServer.html): API reference for Namespace HCI.SunBird.Data.SqlServer.
- [Class SunBirdSqliteExtensions](https://sunbird-doc.hciyork.co.uk/api/HCI.SunBird.Data.Sqlite.SunBirdSqliteExtensions.html): API reference for Class SunBirdSqliteExtensions.
- [Namespace HCI.SunBird.Data.Sqlite](https://sunbird-doc.hciyork.co.uk/api/HCI.SunBird.Data.Sqlite.html): API reference for Namespace HCI.SunBird.Data.Sqlite.
- [Interface ISunBirdBuilder](https://sunbird-doc.hciyork.co.uk/api/HCI.SunBird.Web.ISunBirdBuilder.html): API reference for Interface ISunBirdBuilder.
- [Interface ISunBirdPages](https://sunbird-doc.hciyork.co.uk/api/HCI.SunBird.Web.ISunBirdPages.html): API reference for Interface ISunBirdPages.
- [Class SbFileTagHelper](https://sunbird-doc.hciyork.co.uk/api/HCI.SunBird.Web.SbFileTagHelper.html): API reference for Class SbFileTagHelper.
- [Class SbFragmentTagHelper](https://sunbird-doc.hciyork.co.uk/api/HCI.SunBird.Web.SbFragmentTagHelper.html): API reference for Class SbFragmentTagHelper.
- [Class SbHtmlTagHelper](https://sunbird-doc.hciyork.co.uk/api/HCI.SunBird.Web.SbHtmlTagHelper.html): API reference for Class SbHtmlTagHelper.
- [Class SbIconTagHelper](https://sunbird-doc.hciyork.co.uk/api/HCI.SunBird.Web.SbIconTagHelper.html): API reference for Class SbIconTagHelper.
- [Class SbImageTagHelper](https://sunbird-doc.hciyork.co.uk/api/HCI.SunBird.Web.SbImageTagHelper.html): API reference for Class SbImageTagHelper.
- [Class SbLinkTagHelper](https://sunbird-doc.hciyork.co.uk/api/HCI.SunBird.Web.SbLinkTagHelper.html): API reference for Class SbLinkTagHelper.
- [Class SbRepeaterTagHelper](https://sunbird-doc.hciyork.co.uk/api/HCI.SunBird.Web.SbRepeaterTagHelper.html): API reference for Class SbRepeaterTagHelper.
- [Class SbScopeTagHelper](https://sunbird-doc.hciyork.co.uk/api/HCI.SunBird.Web.SbScopeTagHelper.html): API reference for Class SbScopeTagHelper.
- [Class SbSeoTagHelper](https://sunbird-doc.hciyork.co.uk/api/HCI.SunBird.Web.SbSeoTagHelper.html): API reference for Class SbSeoTagHelper.
- [Class SbSubPagesTagHelper](https://sunbird-doc.hciyork.co.uk/api/HCI.SunBird.Web.SbSubPagesTagHelper.html): API reference for Class SbSubPagesTagHelper.
- [Class SbTableTagHelper](https://sunbird-doc.hciyork.co.uk/api/HCI.SunBird.Web.SbTableTagHelper.html): API reference for Class SbTableTagHelper.
- [Class SbTextTagHelper](https://sunbird-doc.hciyork.co.uk/api/HCI.SunBird.Web.SbTextTagHelper.html): API reference for Class SbTextTagHelper.
- [Class SunBirdEndpointRouteBuilderExtensions](https://sunbird-doc.hciyork.co.uk/api/HCI.SunBird.Web.SunBirdEndpointRouteBuilderExtensions.html): API reference for Class SunBirdEndpointRouteBuilderExtensions.
- [Class SunBirdFragmentAttribute](https://sunbird-doc.hciyork.co.uk/api/HCI.SunBird.Web.SunBirdFragmentAttribute.html): API reference for Class SunBirdFragmentAttribute.
- [Class SunBirdHostBuilderExtensions](https://sunbird-doc.hciyork.co.uk/api/HCI.SunBird.Web.SunBirdHostBuilderExtensions.html): API reference for Class SunBirdHostBuilderExtensions.
- [Class SunBirdPageAttribute](https://sunbird-doc.hciyork.co.uk/api/HCI.SunBird.Web.SunBirdPageAttribute.html): API reference for Class SunBirdPageAttribute.
- [Class SunBirdPageLink](https://sunbird-doc.hciyork.co.uk/api/HCI.SunBird.Web.SunBirdPageLink.html): API reference for Class SunBirdPageLink.
- [Class SunBirdTemplateAttribute](https://sunbird-doc.hciyork.co.uk/api/HCI.SunBird.Web.SunBirdTemplateAttribute.html): API reference for Class SunBirdTemplateAttribute.
- [Namespace HCI.SunBird.Web](https://sunbird-doc.hciyork.co.uk/api/HCI.SunBird.Web.html): API reference for Namespace HCI.SunBird.Web.
- [Release notes](https://sunbird-doc.hciyork.co.uk/release-notes/index.html): What changed in each released version of SunBird, newest first, with notes on upgrading.
- [SunBird 1.1.0](https://sunbird-doc.hciyork.co.uk/release-notes/1-1-0.html): What is new in SunBird 1.1.0, an MCP server so agents can edit content, the sb-table and sb-icon tag helpers, and a clearer outline for edited slots, with upgrade notes including the new MCP tokens table.