https://github.com/artberri/nombres

Data Visualization WebApp of 100 years of Spanish first names.
https://github.com/artberri/nombres

blazor data-visualization netcore spain webapp webassembly

Last synced: 23 days ago
JSON representation

Data Visualization WebApp of 100 years of Spanish first names.

• Host: GitHub
• URL: https://github.com/artberri/nombres
• Owner: artberri
• License: other
• Created: 2018-05-14T00:10:24.000Z (over 6 years ago)
• Default Branch: master
• Last Pushed: 2018-09-17T20:34:31.000Z (about 6 years ago)
• Last Synced: 2024-06-12T02:57:27.339Z (5 months ago)
• Topics: blazor, data-visualization, netcore, spain, webapp, webassembly
• Language: C#
• Size: 15.1 MB
• Stars: 2
• Watchers: 2
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

        
# Nombres

[![License](https://img.shields.io/badge/License-Apache%202.0-blue.svg)](https://opensource.org/licenses/Apache-2.0)

![Build Status](https://berriart.visualstudio.com/_apis/public/build/definitions/436fee41-609f-4897-b276-9c77adfba929/9/badge)

[![Docker Image](https://images.microbadger.com/badges/version/artberri/nombres.svg)](https://hub.docker.com/r/artberri/nombres/)

**Data Visualization WebApp of 100 years of Spanish first names.**

*Disclaimer: This is a "pet project" and could be abandoned at any time.*

![Screenshot](screenshot.png)

A simple example of how [Blazor](https://github.com/aspnet/Blazor), an experimental web UI framework running client-side via WebAssembly, can be used to build single page applications against an API, share code with it or execute JS code from C#.

## Docker Image

"Nombres" has not been deployed to any server yet. For now, the only way to demo it is using the image available on docker hub at [artberri/nombres](https://hub.docker.com/r/artberri/nombres/). To pull the latest version of the image, run the following command:

```bash

docker pull artberri/nombres

```

To run the image, exec the following command:

```bash

docker run -it --rm -p 8080:5000 artberri/nombres

```

After running above command see the web at [http://localhost:8080](http://localhost:8080)

## Requirements

The following software needs to be installed:

- [.NET Core 2.1 RC1 SDK](https://www.microsoft.com/net/download/dotnet-core/sdk-2.1.300-rc1)

- [Visual Studio Code](https://code.visualstudio.com/)

To make the development more fun, this project has been done under Linux :P

## Building and Running the Project

### Running and Debugging the Web API

Open the project in Visual Studio Code and hit Ctrl+F5 (or just F5) to start the .NET Core API.

If running from the command line:

```bash

dotnet run --project src/Names.API/Names.API.csproj

```

### Running the Web App

Run in the command line:

```bash

dotnet run --project src/Names.Web/Names.Web.csproj

```

### Running all with Docker Compose

This project has a `docker-compose.yml` file that will help you running the project locally.

```bash

docker-compose up --build

```

## To Do List

- Create PWA

- Allow to search more names