Development Environment

Development Environment Setup

This guide will help you set up a complete development environment for Mixcore CMS.

Required Tools

1. .NET Development Tools

• .NET 9.0 SDK
• Visual Studio 2022 (Windows)
  • Workloads:
    • ASP.NET and web development
    • .NET desktop development
    • Azure development
• Visual Studio Code (Cross-platform)
  • Extensions:
    • C# for Visual Studio Code
    • .NET Core Tools
    • C# Extensions
    • NuGet Package Manager
    • GitLens

2. Database

• SQL Server
• SQL Server Management Studio
• Azure Data Studio (Optional)

3. Version Control

• Git
• GitHub Desktop (Optional)

4. Containerization (Optional)

• Docker Desktop
• Docker Compose

Environment Setup

Windows

1. Install Chocolatey (Package Manager):

   Set-ExecutionPolicy Bypass -Scope Process -Force; [System.Net.ServicePointManager]::SecurityProtocol = [System.Net.ServicePointManager]::SecurityProtocol -bor 3072; iex ((New-Object System.Net.WebClient).DownloadString('https://community.chocolatey.org/install.ps1'))

2. Install required tools using Chocolatey:

   choco install dotnetcore-sdk visualstudio2022community git docker-desktop sql-server-express ssms

macOS

1. Install Homebrew:

   /bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

2. Install required tools:

   brew install --cask visual-studio-code dotnet docker
   brew install git

Linux (Ubuntu/Debian)

1. Install required tools:

   wget https://packages.microsoft.com/config/ubuntu/20.04/packages-microsoft-prod.deb -O packages-microsoft-prod.deb
   sudo dpkg -i packages-microsoft-prod.deb
   sudo apt-get update
   sudo apt-get install -y dotnet-sdk-9.0 git docker.io docker-compose

IDE Configuration

Visual Studio

1. Open Visual Studio Installer
2. Modify your installation
3. Select these workloads:
   • ASP.NET and web development
   • .NET desktop development
   • Azure development

Visual Studio Code

1. Install the following extensions:

   code --install-extension ms-dotnettools.csharp
   code --install-extension ms-dotnettools.vscode-dotnet-runtime
   code --install-extension formulahendry.dotnet-test-explorer
   code --install-extension jmrog.vscode-nuget-package-manager

Database Setup

1. Install SQL Server

2. Create a new database:

   CREATE DATABASE mixcore;

3. Update connection string in appsettings.json:

   {
     "ConnectionStrings": {
       "DefaultConnection": "Server=localhost;Database=mixcore;Trusted_Connection=True;"
     }
   }

Docker Setup (Optional)

1. Install Docker Desktop

2. Verify installation:

   docker --version
   docker-compose --version

3. Test Docker:

   docker run hello-world

Git Configuration

1. Configure Git:

   git config --global user.name "Your Name"
   git config --global user.email "[email protected]"

2. Generate SSH key (if needed):

   ssh-keygen -t ed25519 -C "[email protected]"

Next Steps

• Quick Start Guide
• First Application Tutorial
• Architecture Overview

Troubleshooting

If you encounter any issues during setup:

1. Check the Common Issues guide
2. Visit our Community Forum
3. Contact Support for enterprise assistance