> For the complete documentation index, see [llms.txt](https://docs.bfren.dev/jeebs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.bfren.dev/jeebs/apps.md).

# Apps

## Hello World

The simplest way to get started with a web app is using the Minimal API syntax of .NET 6.

### 1: Create project

In Visual Studio, create a new project using the 'ASP.NET Core Empty' project template - make sure you select .NET 6.

### 2: Add package

Add the Jeebs.Apps.WebApps package using NuGet.

### 3: Add config

The jeebs library uses a custom json file for configuration.  Create jeebsconfig.json and add the following:

```javascript
{
  "jeebs": {
    "app": {
      "name": "Jeebs App"
    },
    "logging": {
      "minimumLevel": "Information",
      "console": true
    }
  }
}
```

### 4: Edit Program.cs

Add the following to your Program.cs file:

```csharp
var (app, log) = Jeebs.Apps.Builder.Create(args);

app.MapGet("/", () => "Hello, world!");

log.Information("Ready to go.");

app.Run();
```

### 5: Run app

Hit run and you should see something like this in your default browser (you may need to bypass the security warning first):

![](/files/-Mjs7AwpFvFcqxjQJ5Qh)

And something like this in the terminal output:

```csharp
[10:15:14 INF] Jeebs App | Application configured. | Jeebs.Apps.MinimalApiApp
[10:15:14 INF] Jeebs App | Ready to go. | Jeebs.Apps.MinimalApiApp
[10:15:14 INF] Now listening on: https://localhost:5000 | Microsoft.Hosting.Lifetime
[10:15:14 INF] Application started. Press Ctrl+C to shut down. | Microsoft.Hosting.Lifetime
[10:15:14 INF] Hosting environment: Development | Microsoft.Hosting.Lifetime
[10:15:14 INF] Content root path: C:\src\WebApplication1 | Microsoft.Hosting.Lifetime
```

Congratulations, you've run your first Jeebs app!


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.bfren.dev/jeebs/apps.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
