Agility CMS & .NET 5 Starter

To start using the Agility CMS & .NET 5 Starter, sign up for a FREE account and create a new Instance using the Blog Template.

Introduction to .NET5 and Agility CMS

About This Starter

• Uses the latest version of .NET, with greatly improved performance across many components, Language improvements to C# and F#, and much more.
• Supports full Page Management
• Supports Preview Mode
• Includes an easy-to-use CLI tool that helps you download the Content Models from your Agility CMS instance, and generates the classes of the Content Models for you.

Tailwind CSS

This starter uses Tailwind CSS, a simple and lightweight utility-first CSS framework packed with classes that can be composed to build any design, directly in your markup.

It also comes equipped with Autoprefixer, a plugin which use the data based on current browser popularity and property support to apply CSS prefixes for you.

Getting Started

🚨 Before you dive into the code, it's important that you have the latest version of the .NET SDK installed on your machine (>=v5.0), as the project will not run without this.

Generating/Syncing Content Models from your Agility Instance

1. cd into the Agility.NET5.AgilityCLI directory.
2. Rename the App.config.example file to App.config.
3. Overwrite the values in the App.config file with the values from the API Keys page in Agility Settings.
4. Run dotnet run update preview to download the Content Models from your Agility CMS instance, and generate the classes of the Content Models for you.

Setting up the Starter

1. cd into the Agility.NET5.Starter directory.
2. Rename the appsetting.json.example file to appsettings.json.
3. Overwrite the values in the appsettings.json file with the credentials from the API Keys page in Agility Settings.

Running the Site Locally

• dotnet build => Builds your .NET project.
• dotnet run => Builds & runs your .NET project.
• dotnet clean => Cleans the build outputs of your .NET project.

How It Works

• How Pages Work
• How Page Modules Work
• How Page Templates Work

Deploy to Azure Web App

1. Create an Web App (server) to host your application by clicking Azure Deploy button below:
   

2. Deploy your source to Web App by following the steps here How to Deploy .NET 5.0 Starter to Azure

Resources

Agility CMS

• Official site
• Documentation

.NET 5

• Official site
• Documentation

Tailwind CSS

• Official site
• Documentation

Community

• Official Slack
• Blog
• GitHub
• Forums
• Facebook
• Twitter

Feedback and Questions

If you have feedback or questions about this starter, please use the Github Issues on this repo, join our Community Slack Channel or create a post on the Agility Developer Community.