Developing websites with Umbraco

    Umbraco is built on top of a Microsoft MVC framework. You can build upon this technology to work alongside and extend the functionality in Umbraco. It is also designed to be pluggable so that you can replace key components with your own custom implementations if prefer.

    It is possible to build an Umbraco site without Visual Studio and the techniques on this page - see the Creating websites with Umbraco section.

    This section is dedicated to introducing techniques that will help you get started with developing with an Umbraco site. You'll find out how to develop with the framework of an Umbraco project as well as how to extend and customize the Umbraco backoffice.

    The concepts in this section go beyond standard templating methodologies, and introduce some Umbraco-specific terms and helpers, such as SurfaceControllers and management service APIs. All of which is technology that you can take advantage of when developing with Umbraco.

    You will also find information regarding Umbraco's underlying dependency injection framework.

    This will break into two sections: Extending the Umbraco backoffice and Developing custom websites.

    Extending the Umbraco backoffice

    The Umbraco backoffice can be extended using AngularJS and C#. Customizing the Umbraco backoffice and editing experience includes creating your own Property Editors, Dashboards, and packages. You will also find information about how to customize things like Health Checks and the built-in search functionality.

    Checkout the Extending section of these docs for a good place to start.

    From a frontend perspective, Umbraco does not dictate HTML, CSS, or JS in your website build. There is nothing Umbraco specific about it.

    Customizing Umbraco sites

    Umbraco is highly customizable which means you can integrate it with anything and make it behave as you want. With Umbraco, you start out with a clean slate.

    Umbraco uses ASP.NET and MVC patterns and you can extend and write your own controllers using the approach outlined in this section.

    Umbraco on devices

    Integrated Development Environment (IDE) recommendations

    When you are customizing or extending your Umbraco website using C# we recommend using Visual Studio.

    You can also use a simpler tool like Visual Studio Code or any other text editor you prefer working with. However, this is only recommended when you're not working directly with the C# files.

    While you can use a text editor, put changes in the App_code folder, and have it compiled on startup; we recommend using an IDE.

    An IDE will give you a lot of support, as it's built for working with C# files, ASP.NET and MVC frameworks.