{"id":13596946,"url":"https://github.com/SoftwareAteliers/asp-net-core-vue-starter","last_synced_at":"2025-04-09T20:31:41.296Z","repository":{"id":37706475,"uuid":"146019524","full_name":"SoftwareAteliers/asp-net-core-vue-starter","owner":"SoftwareAteliers","description":"ASP.NET Core + Vue.js starter project","archived":false,"fork":false,"pushed_at":"2024-10-01T21:48:16.000Z","size":3198,"stargazers_count":560,"open_issues_count":30,"forks_count":121,"subscribers_count":22,"default_branch":"master","last_synced_at":"2025-03-21T05:06:37.375Z","etag":null,"topics":["asp-net-core","starter","starter-template","template","typescript","vue","vue-cli-4","vuex","web-api"],"latest_commit_sha":null,"homepage":null,"language":"Vue","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/SoftwareAteliers.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null}},"created_at":"2018-08-24T17:13:13.000Z","updated_at":"2025-03-20T03:18:19.000Z","dependencies_parsed_at":"2024-01-02T23:25:38.510Z","dependency_job_id":"47fa9e2f-9295-48b3-88dd-9751c5d0d40d","html_url":"https://github.com/SoftwareAteliers/asp-net-core-vue-starter","commit_stats":{"total_commits":111,"total_committers":13,"mean_commits":8.538461538461538,"dds":"0.22522522522522526","last_synced_commit":"808e94b622865acfa7d116860f87ec3268b5b4e4"},"previous_names":[],"tags_count":27,"template":true,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/SoftwareAteliers%2Fasp-net-core-vue-starter","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/SoftwareAteliers%2Fasp-net-core-vue-starter/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/SoftwareAteliers%2Fasp-net-core-vue-starter/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/SoftwareAteliers%2Fasp-net-core-vue-starter/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/SoftwareAteliers","download_url":"https://codeload.github.com/SoftwareAteliers/asp-net-core-vue-starter/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248107403,"owners_count":21048922,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["asp-net-core","starter","starter-template","template","typescript","vue","vue-cli-4","vuex","web-api"],"created_at":"2024-08-01T16:02:59.378Z","updated_at":"2025-04-09T20:31:40.669Z","avatar_url":"https://github.com/SoftwareAteliers.png","language":"Vue","funding_links":[],"categories":["Vue","Resources","Awesome Vue.js [![Awesome](https://cdn.rawgit.com/sindresorhus/awesome/d7305f38d29fed78fa85652e3a63e154dd8e8829/media/badge.svg) ★101652](https://github.com/sindresorhus/awesome)","Awesome Vue.js [![Awesome](https://cdn.rawgit.com/sindresorhus/awesome/d7305f38d29fed78fa85652e3a63e154dd8e8829/media/badge.svg)](https://github.com/sindresorhus/awesome)","Examples [🔝](#readme)"],"sub_categories":["Examples"],"readme":"# ASP.NET Core Vue Starter\n\nThe repository contains an ASP.\u0026#8203;NET Core + Vue.js starter template. The template runs on ASP.NET Core 5.0 and is created by Vue CLI 4.0 with a new plugin based architecture allowing developers to interactively scaffold a new project with just a one command.\n\nOriginal article how to create the starter template is available [here](https://medium.com/software-ateliers/asp-net-core-vue-template-with-custom-configuration-using-cli-3-0-8288e18ae80b).\n\n[![Nuget](https://img.shields.io/nuget/v/SoftwareAteliers.AspNetCoreVueStarter.svg?style=flat\u0026color=2196f3)](https://www.nuget.org/packages/SoftwareAteliers.AspNetCoreVueStarter/)\n\n\u003e For ASP.NET Core 3.1 template use [release v2.6.0](https://github.com/SoftwareAteliers/asp-net-core-vue-starter/releases/tag/2.6.0)\n\n\u003e For ASP.NET Core 2.2 template use [release v1.1.0](https://github.com/SoftwareAteliers/asp-net-core-vue-starter/releases/tag/1.1.0)\n---\n\n## Table of Contents\n\n* [Features](#features)\n* [Used Technology Stack](#used-technology-stack)\n* [Prerequisites](#prerequisites)\n* [Getting Started](#getting-started)\n\n## Features\n\n* Hot module replacement\n* Code-splitting\n* Tree-shaking\n* ES2017 transpilation\n* Long term caching and so on\n\n## Used Technology Stack\n\n**ASP.NET Core 5.0:**\n\n* Web.API\n* Vue CLI and JavaScript Services middlewares to integrate with client app\n\n**Vue.js with CLI 4.0 supporting optional integrations:**\n\n* TypeScript\n* Progressive Web App\n* Vue Router \u0026 Vuex (State Store)\n* Linting, unit testing, E2E testing\n* 3rd party component frameworks (Vuetify, Vue Bootstrap etc.)\n* publish your personal/enterprise plugin and so on...\n\n*For a full feature list, I suggest you to read the [official CLI release statement](https://medium.com/the-vue-point/vue-cli-3-0-is-here-c42bebe28fbb) by Evan You.*\n\n## Prerequisites\n\n* [.NET Core](https://www.microsoft.com/net/download/windows) \u003e= 5.0\n* [NodeJS](https://nodejs.org/) \u003e= 8.9\n* [Vue CLI](https://cli.vuejs.org/) \u003e= 4.0\n* Your favourite editor (I prefer [VS Code](https://code.visualstudio.com/)), or VS 2017/19\n\n---\n\n## Getting started\n\nThere are two ways how to set up the project: one for people who want to create their own template and choose custom integrations and the other for developers who want to start with no configuration.\n\n## Clone the starter with default configuration\n\n* Clone this repository `git clone https://github.com/SoftwareAteliers/asp-net-core-vue-starter`\n\nor you can use .NET Core CLI templates:\n\n* Install the template from NuGet repository: `dotnet new -i SoftwareAteliers.AspNetCoreVueStarter`\n\n* Initialize the project: `dotnet new vue -o MyProject`\n\n## (Optional) Scaffold Vue.js app with custom configuration\n\nIf you prefer to overwrite default Vue client app with custom settings, take the following steps:\n\n* **Remove all the contents** of the folder /ClientApp\n* Create a new Vue project by using Vue CLI: `vue create client-app` OR by using CLI graphical interface running `vue ui`\n\n\u003e Unfortunately Vue CLI does not allow us to set a project name by C# standards using Upper Camel Case (Pascal Case) naming convention, so let's initiate app inside of client-app folder and then move the content to ClientApp.\n\n* **Move all the contents from the new folder /client-app to /ClientApp.**\n\nNow application is ready to run.\n\n## Run the application\n\nYou have three choices when it comes to how you prefer to run the app. You can either use the command line or the build-in run command.\n\n### 1. Using the command line\n\n* Run the .NET application using `dotnet run`\n\n### 2. Using the built-in run command\n\n* Run the application in VSCode or Visual Studio 2017 by hitting `F5`\n\n\u003e It will take some time during the first run to download all client side dependencies.\n\nBrowse to [http://localhost:5000](http://localhost:5000) for ASP.\u0026#8203;NET Core + Vue app or browse to [http://localhost:8080](http://localhost:8080) for Vue app only.\n\n![Application screenshot](./screenshot.png)\n\n## Publish the application\n\n### 1. Folder output\n\n* Run the .NET publish command using Release configuration: `dotnet publish -c Release`\n\nor\n\n* Follow the Publish wizard in Visual Studio selecting Folder profile.\n\n### 2. Docker output\n\n* Run the following command in a cmd window to build the docker image:\n`docker build -t \u003cIMAGE_NAME\u003e .`\n\n\u003e ATTENTION! Do not miss the final dot to build the current directory\n\n* Run the application in a cmd window by this command:\n`docker run -d -p 5000:80 \u003cIMAGE_NAME\u003e`\n\n## View your application running\n\n\n## Recommended plugin for debugging Vue\n\n* Get Chrome DevTools for Vue.js [here](https://chrome.google.com/webstore/detail/vuejs-devtools/nhdogjmejiglipccpnnnanhbledajbpd)\n\n---\n\n## Issues and Contribution\n\nWant to file a bug, contribute some code, or improve documentation? Excellent! Please make sure to check existing issues before opening a new one.\n\n---\n\n## Contributors\n\nSpecial thanks to everyone who helped and contributed to this project!\n\n* [@jdebarochez](https://github.com/jdebarochez)\n* [@arisliang](https://github.com/arisliang)\n* [@dotnetshadow](https://github.com/dotnetshadow)\n* [@NickStees](https://github.com/NickStees)\n* [@wallyjue](https://github.com/wallyjue)\n* [@Ibrahim-Islam](https://github.com/Ibrahim-Islam)\n* [@bickycheese](https://github.com/bickycheese)\n* [@nickyg91](https://github.com/nickyg91)\n* [@glebov21](https://github.com/glebov21)\n* [@TobbenTM](https://github.com/TobbenTM)\n* [@JohnCampionJr](https://github.com/JohnCampionJr)\n\n---\n\n## License\n\n[![MIT License](https://img.shields.io/badge/license-MIT-blue.svg?style=flat)](https://mit-license.org/)\n\nCopyright \u0026copy; 2018 - 2022 [Software Ateliers](https://github.com/SoftwareAteliers)\n\n## Where to find me\n\nMedium: [Software Ateliers](https://medium.com/software-ateliers) | Twitter: [@SAteliers](https://twitter.com/SAteliers)","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FSoftwareAteliers%2Fasp-net-core-vue-starter","html_url":"https://awesome.ecosyste.ms/projects/github.com%2FSoftwareAteliers%2Fasp-net-core-vue-starter","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FSoftwareAteliers%2Fasp-net-core-vue-starter/lists"}