Ensure your system is properly configured to meet all prerequisites for Geta Foundation Core listed here

    git clone /~https://github.com/Geta/geta-foundation-web.git
    cd geta-foundation-web
    git submodule update --init

    # Windows
    cd sub/geta-foundation-core/src/Foundation.AppHost
    dotnet run

    # Linux / MacOS
    sudo env "PATH=$PATH" bash
    chmod +x sub/geta-foundation-core/src/Foundation/docker/build-script/*.sh
    cd sub/geta-foundation-core/src/Foundation.AppHost
    dotnet run

   # Windows
   cd sub/geta-foundation-core
   ./setup.cmd
   cd ../../src/Foundation.Web
   dotnet run

   # Linux / MacOS
   sudo env "PATH=$PATH" bash
   cd sub/geta-foundation-core
   chmod +x *.sh
   ./setup.sh
   cd ../../src/Foundation.Web
   dotnet run

If you run into any issues, check the FAQ section here

Q: I have trouble executing *.sh files on Linux / MacOS

A: You need to mark file as executable

   chmod +x ./my-file.sh
   ./my-file.sh

Q: I get errors when running Aspire on Linux

A: You need to run process as administrator

    sudo dotnet run

Q: I am using NVM and get error npm - command not found on Linux

A: You need to pass PATH variable when running as administrator

    sudo env "PATH=$PATH" dotnet run

1. Add submodule to your project:

   cd yourProjectDirectory
   mkdir sub
   cd sub
   git submodule add /~https://github.com/Geta/geta-foundation-core.git

2. Create web project (.net 9):

   cd yourProjectDirectory
   mkdir src
   dotnet new web --name yourProjectName.Web --output src/yourProjectName.Web

3. Add Foundation reference and modules importer

    <!-- yourProjectName.Web.csproj -->
    <ItemGroup>
      <ProjectReference Include="..\..\sub\geta-foundation-core\src\Foundation\Foundation.csproj" />
    </ItemGroup>
   
    <Import Project="..\..\sub\geta-foundation-core\src\Foundation\modules\ModulesInclude.proj"/>

4. Create startup.cs file

   public class Startup(IWebHostEnvironment webHostingEnvironment, IConfiguration configuration)
   {
       private readonly Foundation.Startup _foundationStartup = new(webHostingEnvironment, configuration);
   
       public void ConfigureServices(IServiceCollection services)
       {
           _foundationStartup.ConfigureServices(services);
       }
   
       public void Configure(IApplicationBuilder app, IWebHostEnvironment env)
       {
           _foundationStartup.Configure(app, env);
       }
   }

5. Adjust program.cs file

   using yourProjectNameWebNamespace;
   
   Host.CreateDefaultBuilder(args)
   .ConfigureCmsDefaults()
   .ConfigureWebHostDefaults(webBuilder =>
   {
       webBuilder.UseStartup<Startup>();
       webBuilder.UseContentRoot(Path.GetFullPath("../../sub/geta-foundation-core/src/Foundation"));
   })
   .Build()
   .Run();

6. Add AppHostConfiguration to appsettings.json

   "AppHost": {
     "SqlServerName": "yourSqlServerName",
     "CmsDatabaseName": "yourProjectName-cms",
     "CommerceDatabaseName": "yourProjectName-commerce",
     "WebName": "yourProjectName"
   }
   

7. Run Foundation.AppHost