@codedesignplus/netcore

An Nx plugin tailored for streamlined .NET Core development.
Explore the docs »

About the Project
Prerequisites
Usage
- Install
- Using the "library" Generator
Roadmap
Contributing
License
Contact
Acknowledgements

The project introduces the @codedesignplus/netcore plugin for Nx. Crafted to bolster the .NET development process, this plugin offers an array of generators and executors. These tools have been meticulously designed to enhance productivity, drawing inspiration and structure from established archetypes, including:

library: A foundational archetype facilitating library development in .NET. Dive deeper into its capabilities at CodeDesignPlus.Net.Library.
rest: An archetype dedicated to RESTful application development, currently under active development.
grpc: Geared towards the development of efficient gRPC applications, this archetype is in the pipeline.
graphql: Targeting the modern GraphQL architecture, this archetype is also under construction.

Stay tuned for continuous enhancements and additions that aim to redefine the .NET development experience.

Prerequisites

Before you begin, ensure you have met the following requirements:

Nx CLI installed
.NET SDK

Usage

Harnessing the power of the @codedesignplus/netcore plugin is straightforward. Once integrated into your Nx workspace, the plugin brings a suite of commands to your fingertips. To get started, invoke the provided generators or executors depending on your project's needs. Whether you're initiating a new .NET library or crafting a modern GraphQL backend, the plugin's intuitive command structure simplifies your development flow. Consult the provided documentation for each archetype to dive deeper into specific command structures and best practices. With @codedesignplus/netcore, setting up, developing, and optimizing your .NET projects becomes a seamless experience.

Install

Install Nx CLI (if you haven't already):
```
npm install -g @nrwl/cli
```

Create a new Nx workspace (if needed):

npx create-nx-workspace@latest myworkspace --pm pnpm

Install the @codedesignplus/netcore plugin:
```
nx add @codedesignplus/netcore
```

Using the "library" Generator

The primary functionality of this plugin is the library generator, which aids in creating .NET libraries.

Generate a new library:
```
nx generate @codedesignplus/netcore:library --name=YourLibraryName --org=YourOrgName
```
Replace YourLibraryName with the desired name for your library and YourOrgName with your organization's name. If you don't provide the org parameter, the default CodeDesignPlus will be used.
Explore your project: The structure of the generated project will be located in the packages/YourOrgName.Net.YourLibraryName directory. Here, you'll find all files and folders related to your new .NET library.
Develop and Expand: Utilize the generated files and structure to develop your library further. Refer to the specific documentation for @codedesignplus/netcore or the archetype you're using for best practices and helpful insights.
Build and Test: Use the tools and commands provided by Nx and the plugin to build, test, and optimize your library before publishing or integrating it into larger applications.

Roadmap

Refer to issues for a list of proposed features and known issues.

Contributing

Fork the Project
Create your Feature Branch (git checkout -b features/AmazingFeature)
Commit your Changes (git commit -m 'Add some AmazingFeature')
Push to the Branch (git push origin feature/AmazingFeature)
Open a Pull Request

@codedesignplus/netcore