How do I add a new feature or module in Nucleus?

Extend the backend by adding new controllers, services, and models following the layered architecture, and update the Vue frontend with components and routes. Refer to existing code for patterns, but note that V2 documentation is sparse.

Nucleus or Clean Architecture for ASP.NET Core: which should I choose?

Nucleus is better for full-stack Vue.js integration with pre-configured tools like JWT auth, while Clean Architecture offers more flexibility for backend-only projects. Choose based on your need for an all-in-one solution versus custom backend design.

Can I use Nucleus with a different database than SQL Server?

Yes, but it requires manual configuration since Entity Framework Core supports multiple databases. You'll need to adjust connection strings and migrations, as the template doesn't provide out-of-the-box support for alternatives.

How to customize the Vue frontend styling in Nucleus?

Override PrimeVue themes or add custom CSS in the Vue components. The template uses PrimeVue's theming system, so consult its documentation for advanced customizations beyond the provided setup.

Does Nucleus support role-based authorization?

Yes, it uses ASP.NET Core Identity with JWT tokens, which can be extended for roles and claims. However, implementation details might be limited in the current V2 documentation, so you may need to rely on .NET Core docs.

What are the deployment steps for a Nucleus application?

Deploy the ASP.NET Core backend to a server or cloud platform like Azure, and host the Vue frontend on a static service. The template doesn't include deployment scripts, so you'll need to set up CI/CD pipelines manually.

Open-Awesome

Nucleus

MITC#v1.1.0

A Vue.js and ASP.NET Core startup template with JWT authentication and layered architecture.

GitHub

352 stars84 forks0 contributors

What is Nucleus?

Nucleus is a full-stack startup template that combines Vue.js for the frontend with ASP.NET Core for the backend, featuring JWT-based authentication and a layered architecture. It provides a pre-configured foundation for building secure, scalable web applications with essential tools like Entity Framework Core, logging, and API documentation. The template aims to reduce initial setup time and enforce best practices in modern web development.

Target Audience

Full-stack developers or teams building web applications with Vue.js and ASP.NET Core who want a production-ready starting point with authentication and structured architecture.

Value Proposition

Developers choose Nucleus for its integrated, opinionated stack that includes security, logging, and UI components out-of-the-box, eliminating common setup hurdles. Its layered design promotes maintainability, while JWT authentication and Swagger support streamline API development and testing.

Overview

Vue startup application template that uses ASP.NET Core API layered architecture at the back-end and JWT based authentication

Use Cases

Best For

Starting new Vue.js and ASP.NET Core projects quickly
Implementing JWT authentication in full-stack applications
Building applications with a clean layered architecture
Developing enterprise web apps with structured logging and error handling
Creating multilingual Vue.js interfaces with Vue i18n
Using PrimeVue components for consistent UI development

Not Ideal For

Projects requiring a different frontend framework like React or Angular
Simple prototypes or MVPs where the layered architecture adds unnecessary complexity
Teams needing comprehensive, stable documentation, as V2 is still in development with incomplete docs
Applications that require built-in real-time features or alternative authentication methods beyond JWT

Pros & Cons

Pros

Production-Ready Authentication

Integrates JWT-based authentication with ASP.NET Core Identity, providing secure API access and user management out-of-the-box.

Structured Layered Architecture

Uses a clean separation of concerns in the backend with distinct layers for API, business logic, and data access, promoting maintainability and scalability.

Integrated UI Component Library

Includes PrimeVue for Vue.js, offering a rich set of pre-built components to accelerate frontend development with consistent styling.

Comprehensive Development Tooling

Comes with Serilog for structured logging, Automapper for object mapping, and Swagger for auto-generated API documentation, reducing boilerplate setup.

Cons

Incomplete Development State

Version V2 is still in development, leading to missing documentation, potential instability, and breaking changes that could hinder production use.

Complex Technology Stack

Requires deep familiarity with both Vue.js and ASP.NET Core ecosystems, making it challenging for developers new to either technology.

Opinionated and Inflexible

Locked into specific choices like PrimeVue and Entity Framework Core, making it difficult to swap out components or libraries without significant refactoring.

Frequently Asked Questions

Related Projects

bitwarden-core

Bitwarden infrastructure/backend (API, database, Docker, etc).

Stars19,321

Forks1,682

Last commit6 hours ago

.NET Boxed Templates

.NET project templates with batteries included, providing the minimum amount of code required to get you going faster.

[Archived] This repository has been archived

Stars3,007

Forks512

Last commit6 years ago

Serene

Business Apps Made Simple with Asp.Net Core MVC / TypeScript

Stars2,684

Forks804

Last commit17 hours ago

Community-curated · Updated weekly · 100% open source

Found a gem we're missing?

Open-Awesome is built by the community, for the community. Submit a project, suggest an awesome list, or help improve the catalog on GitHub.

Submit a project Star on GitHub