The gothinkster/aspnetcore-realworld-example-app is a full-stack implementation of the "RealWorld" application using ASP.NET Core and Angular. It serves as a demonstration of how to build a real-world application with these technologies, following best practices and modern development patterns.

Pros

• Provides a complete, production-ready example of a full-stack application
• Implements a standardized API specification, making it easy to compare with other implementations
• Uses modern ASP.NET Core features and practices
• Includes comprehensive unit and integration tests

Cons

• May be overwhelming for beginners due to its complexity
• Requires knowledge of both backend (C#, ASP.NET Core) and frontend (Angular) technologies
• Some dependencies may become outdated over time if not regularly maintained
• Limited documentation for customization and extension

Code Examples

Here are a few code examples from the project:

1. User registration endpoint:

[HttpPost]
public async Task<IActionResult> Create([FromBody] RegisterUser.Command command)
{
    await Mediator.Send(command);
    return Ok();
}

This code defines an HTTP POST endpoint for user registration, using MediatR to handle the command.

2. Article creation:

public async Task<ArticleEnvelope> Handle(Create.Command request)
{
    var author = await _context.Persons.FirstAsync(x => x.Username == _currentUserAccessor.GetCurrentUsername());

    var article = new Article()
    {
        Author = author,
        Body = request.Article.Body,
        CreatedAt = DateTime.UtcNow,
        UpdatedAt = DateTime.UtcNow,
        Description = request.Article.Description,
        Title = request.Article.Title,
        Slug = request.Article.Title.GenerateSlug()
    };

    await _context.Articles.AddAsync(article);

    await _context.SaveChangesAsync();

    return new ArticleEnvelope(article);
}

This code handles the creation of a new article, associating it with the current user and generating a slug.

3. JWT token generation:

public string GenerateToken(Person user)
{
    var claims = new[]
    {
        new Claim(JwtRegisteredClaimNames.Sub, user.Username),
        new Claim(JwtRegisteredClaimNames.Jti, Guid.NewGuid().ToString()),
        new Claim(JwtRegisteredClaimNames.UniqueName, user.Username)
    };

    var key = new SymmetricSecurityKey(Encoding.UTF8.GetBytes(_jwtOptions.SecretKey));
    var creds = new SigningCredentials(key, SecurityAlgorithms.HmacSha256);

    var token = new JwtSecurityToken(
        issuer: _jwtOptions.Issuer,
        audience: _jwtOptions.Audience,
        claims: claims,
        expires: DateTime.UtcNow.AddMinutes(_jwtOptions.ExpirationMinutes),
        signingCredentials: creds);

    return new JwtSecurityTokenHandler().WriteToken(token);
}

This code generates a JWT token for user authentication, including claims and an expiration time.

Getting Started

To get started with this project:

1. Clone the repository:

   git clone https://github.com/gothinkster/aspnetcore-realworld-example-app.git
   

2. Navigate to the project directory and restore dependencies:

   cd aspnetcore-realworld-example-app
   dotnet restore
   

3. Run the application:

   dotnet run
   

4. Access the API at http://localhost:5000 and the Angular frontend at http://localhost:4200.