# Serenity

**Repository Path**: douhao9921/Serenity

## Basic Information

- **Project Name**: Serenity
- **Description**: volkanceylan serenity
- **Primary Language**: Unknown
- **License**: MIT
- **Default Branch**: master
- **Homepage**: https://github.com/volkanceylan/Serenity
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 1
- **Created**: 2018-12-21
- **Last Updated**: 2024-12-12

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

Serenity Application Platform
=============================

<img src="https://github.com/serenity-is/Serenity/blob/master/build/assets/package-icon.png" />

[![build](https://github.com/serenity-is/Serenity/actions/workflows/test.yml/badge.svg)](https://github.com/serenity-is/Serenity/actions/workflows/test.yml)  [![version](https://img.shields.io/nuget/v/Serenity.Net.Core.svg?label=version)](http://www.nuget.org/packages/Serenity.Net.Core/)

## What is the Serenity Platform

Serenity is an ASP.NET Core / TypeScript application platform designed to simplify and shorten the development of data-centric business applications with a service-based architecture.

It aims to make development easier while reducing maintenance costs by avoiding boiler-plate code, reducing the time spent on repetitive tasks, and applying best software design practices. 

<img src="https://github.com/serenity-is/Serene/blob/master/build/assets/SereneAnimation.webp" />

## Quickstart (Serene)

> Premium customers should use the StartSharp template which they can download from the [Serenity members area](https://serenity.is/Account/Login/).

Ensure you have the necessary [requirements](https://serenity.is/docs/getting_started/README#prerequisites) installed.
```bash
# Install/Update Serene.Templates package.
> dotnet new install Serene.Templates

# Create a new Serene project.
> dotnet new serene -n MySereneApp

# Navigate into your project folder.
> cd MySereneApp/MySereneApp.Web

# Install NPM packages.
> npm i

# Build and run the project.
> dotnet run
```
That's it! ✨ You can visit `http://localhost:5000` (actual port may vary, check the console after `dotnet run`) to see your running [Serene](https://github.com/serenity-is/Serene) application.

## Documentation and Tutorials

See [Serenity Developer Guide - https://serenity.is/docs](https://serenity.is/docs/) for documentation and step-by-step tutorials.

**Serenity Blog:**
- https://serenity.is/blog/

**Check out the Visual Studio Toolbox Presentation:**
- [Building Web Apps with the Serenity Platform](https://docs.microsoft.com/en-us/shows/visual-studio-toolbox/building-web-apps-with-the-serenity-platform)

## Online Demo

https://demo.serenity.is

## Contribute / Spread the Word

You may contribute to the project by opening a pull request, adding documentation, sample source code, asking a question or suggesting an improvement, etc. Just open a discussion here with relevant links.

Please help spread the word by posting in blogs, forums, and social media, starring the project on GitHub, or reviewing the Serene extension in [VSGallery](https://marketplace.visualstudio.com/items?itemName=VolkanCeylan.SereneSerenityApplicationTemplate&ssr=false#review-details).

## License

Serenity (including its application template Serene) is a free and open-source project with an MIT license, which permits usage in commercial applications. 

## Premium Packages

We offer premium support packages at https://serenity.is. They also include the *StartSharp* template with advanced samples, features, and modules. 

Visit [this document](https://serenity.is/docs/startsharp/README) for more information about what is available in premium support and *StartSharp*.

## Custom Development

Custom development options are available from the author and a team of Serenity professionals. [Contact us](mailto:sales@serenity.is) for details.

## Video Tutorials by Community Members (not official, some might be out of date)

- **Starting Point Videos by @sayuga:** https://www.youtube.com/channel/UCHGyxXj-vI32YaRs0v3HvKw
- **Youtube Channel of @samdubey:** https://www.youtube.com/c/SerenityApplicationFramework
- **Introduction to Serene by @samdubey:** https://www.youtube.com/watch?v=_AqRl_U_gcw
- **Movie Tutorial:** https://www.youtube.com/playlist?list=PLMr_-cvwVIMWBsgWWUYdbHxBHPrOSzWVf
- **Continuous Deployment on Azure by @samdubey:** https://www.youtube.com/watch?v=tcywhS9k9Wc
- **Videos in Arabic by @MohamedEbrahimSaad**: https://www.youtube.com/watch?v=op15-Q2TDjg