CMS & Application Framework for Blazor & .NET MAUI
5.1.1 was released on Apr 16, 2024 and is primarily a stabilization release, including a variety of improvements to the Static Server-Side Rendering support for Blazor in .NET 8. This release includes 40 pull requests by 6 different contributors, pushing the total number of project commits all-time to over 5200. The Oqtane framework continues to evolve at a rapid pace to meet the needs of .NET developers.
Oqtane is an open source CMS and Application Framework that provides advanced functionality for developing web, mobile, and desktop applications on .NET. It leverages Blazor to compose a fully dynamic digital experience which can be hosted on Blazor Server, Blazor WebAssembly, or Blazor Hybrid (via .NET MAUI).
Oqtane is being developed based on some fundamental principles which are outlined in the Oqtane Philosophy.
Please note that this project is owned by the .NET Foundation and is governed by the .NET Foundation Contributor Covenant Code of Conduct
Using Version 5:
Install .NET 8.0.4 SDK.
Install the latest edition (v17.9 or higher) of Visual Studio 2022 with the ASP.NET and web development workload enabled. Oqtane works with ALL editions of Visual Studio from Community to Enterprise. If you wish to use LocalDB for development ( not a requirement as Oqtane supports SQLite, mySQL, and PostgreSQL ) you must also install the Data storage and processing.
Clone the Oqtane dev branch source code to your local system.
Open the Oqtane.sln solution file.
Important: Rebuild the entire solution before running it.
Make sure you specify Oqtane.Server as the Startup Project
Run the application.
Installing an official release:
Additional Instructions
If you have already installed a previous version of Oqtane and you wish to do a clean database install, simply reset the DefaultConnection value in the Oqtane.Server\appsettings.json file to "". This will trigger a re-install when you run the application which will execute the database installation.
If you want to submit pull requests make sure you install the Github Extension For Visual Studio. It is recommended you ignore any local changes you have made to the appsettings.json file before you submit a pull request. To automate this activity, open a command prompt and navigate to the /Oqtane.Server/ folder and enter the command "git update-index --skip-worktree appsettings.json"
Video Series
Explore and enhance your Oqtane experience by visiting the Oqtane Marketplace. Discover a variety of modules, themes, and extensions contributed by the community. Visit Oqtane Marketplace
There is a separate Documentation repository which contains a variety of types of documentation for Oqtane, including API documentation that is auto generated using Docfx. The contents of the repository is published to Githib Pages and is available at https://docs.oqtane.org
This project is open source, and therefore is a work in progress...
Backlog (TBD)
5.1.1 (Apr 16, 2024)
5.1.0 (Mar 27, 2024)
5.0.2 (Jan 25, 2024)
5.0.1 (Dec 21, 2023)
5.0.0 (Nov 16, 2023)
4.0.6 ( Oct 16, 2023 )
4.0.5 ( Sep 26, 2023 )
4.0.4 ( Sep 25, 2023 )
4.0.3 ( Aug 29, 2023 )
4.0.2 ( Aug 9, 2023 )
4.0.1 ( Jul 18, 2023 )
4.0.0 ( Jun 26, 2023 )
3.4.3 ( May 3, 2023 )
3.4.2 ( Mar 29, 2023 )
3.4.1 ( Mar 13, 2023 )
3.4.0 ( Mar 12, 2023 )
3.3.1 ( Jan 14, 2023 )
3.3.0 ( Jan 12, 2023 )
3.2.1 ( Oct 17, 2022 )
3.2.0 ( Sep 13, 2022 )
3.1.3 ( Jun 27, 2022 )
3.1.2 ( May 14, 2022 )
3.1.1 ( May 3, 2022 )
3.1.0 ( Apr 5, 2022 )
3.0.3 ( Feb 15, 2022 )
3.0.2 ( Jan 16, 2022 )
3.0.1 ( Dec 12, 2021 )
3.0.0 ( Nov 11, 2021 )
2.3.1 ( Sep 27, 2021 )
2.2.0 ( Jul 6, 2021 )
2.1.0 ( Jun 4, 2021 )
2.0.2 ( Apr 19, 2021 )
2.0.1 ( Feb 27, 2021 )
2.0.0 ( Nov 11, 2020 )
1.0.0 ( May 19, 2020 )
POC ( May 9, 2019 )
Oqtane was created by Shaun Walker and is inspired by the DotNetNuke web application framework. Initially created as a proof of concept, Oqtane is a native Blazor application written from the ground up using modern .NET Core technology and a Single Page Application (SPA) architecture. It is a modular application framework offering a fully dynamic page compositing model, multi-site support, designer friendly themes, and extensibility via third party modules.
Built On Blazor! - a showcase of sites built on Blazor
.NET Foundation Project Trends - tracks the most active .NET Foundation open source projects based on GitHub activity
The following diagram visualizes the client and server components in the Oqtane architecture.
As of version 2.1, Oqtane supports multiple relational database providers.
Install Wizard:
Default view after installation:
A seamless login flow utilizing .NET Core Identity services:
Main view for authorized users, allowing full management of modules and content:
Content editing user experience using modal dialog:
Context menu for managing specific module on page:
Control panel for adding, editing, and deleting pages as well as adding new modules to a page:
Admin dashboard for accessing the various administrative features of the framework:
Responsive design mobile view: