[Docs] Add Self-Manging your server section and updating quickstart (TS/PY)

teams.md/src/components/include/getting-started/quickstart/csharp.incl.md

@@ -45,3 +45,15 @@ dotnet run
 [INFO] Microsoft.Hosting.Lifetime Application started. Press Ctrl+C to shut down.
 [INFO] Microsoft.Hosting.Lifetime Hosting environment: Development
 ```
+
+<!-- manual-install -->
+
+N/A
+
+<!-- manual-code -->
+
+N/A
+
+<!-- manual-more -->
+
+N/A

teams.md/src/components/include/getting-started/quickstart/python.incl.md

@@ -45,3 +45,47 @@ INFO:     Waiting for application startup.
 INFO:     Application startup complete..
 INFO:     Uvicorn running on http://0.0.0.0:3979 (Press CTRL+C to quit)
 ```
+
+<!-- manual-install -->
+
+```sh
+pip install microsoft-teams-apps
+```
+
+<!-- manual-code -->
+
+```python
+import asyncio
+import uvicorn
+from fastapi import FastAPI
+# highlight-next-line
+from microsoft_teams.apps import App, FastAPIAdapter
+
+# Your existing FastAPI app
+my_fastapi = FastAPI()
+
+# highlight-start
+# Wrap your app in an adapter and create the Teams app
+adapter = FastAPIAdapter(app=my_fastapi)
+app = App(http_server_adapter=adapter)
+
+@app.on_message
+async def handle_message(ctx):
+    await ctx.send(f"You said: {ctx.activity.text}")
+# highlight-end
+
+async def main():
+    # highlight-next-line
+    await app.initialize()  # Register the Teams endpoint (does not start a server)
+
+    # Start your server as usual
+    config = uvicorn.Config(app=my_fastapi, host="0.0.0.0", port=3978)
+    server = uvicorn.Server(config)
+    await server.serve()
+
+asyncio.run(main())
+```
+
+<!-- manual-more -->
+
+See the [HTTP Server guide](../in-depth-guides/server/http-server) for full details on adapters and custom server setups.

teams.md/src/components/include/getting-started/quickstart/typescript.incl.md

@@ -51,3 +51,42 @@ npm run dev
 [INFO] @teams/app/http listening on port 3978 🚀
 [INFO] @teams/app/devtools available at http://localhost:3979/devtools
 ```
+
+<!-- manual-install -->
+
+```sh
+npm i @microsoft/teams.apps
+```
+
+<!-- manual-code -->
+
+```typescript
+import http from 'http';
+import express from 'express';
+// highlight-next-line
+import { App, ExpressAdapter } from '@microsoft/teams.apps';
+
+// Your existing Express server
+const expressApp = express();
+const server = http.createServer(expressApp);
+
+// highlight-start
+// Wrap your server in an adapter and create the Teams app
+const adapter = new ExpressAdapter(server);
+const app = new App({ httpServerAdapter: adapter });
+
+app.on('message', async ({ send, activity }) => {
+  await send(`You said: ${activity.text}`);
+});
+
+// Register the Teams endpoint on your server (does not start it)
+await app.initialize();
+// highlight-end
+
+// Start your server as usual
+server.listen(3978);
+```
+
+<!-- manual-more -->
+
+See the [HTTP Server guide](../in-depth-guides/server/http-server) for full details on adapters and custom server setups.

teams.md/src/components/include/in-depth-guides/server/http-server/csharp.incl.md

@@ -0,0 +1,11 @@
+<!-- adapter-interface -->
+
+N/A
+
+<!-- self-managed -->
+
+N/A
+
+<!-- custom-adapter -->
+
+N/A

teams.md/src/components/include/in-depth-guides/server/http-server/python.incl.md

@@ -0,0 +1,96 @@
+<!-- default-framework -->
+
+[FastAPI](https://fastapi.tiangolo.com/)
+
+<!-- adapter-interface -->
+
+```python
+class HttpServerAdapter(Protocol):
+    def register_route(self, method: HttpMethod, path: str, handler: HttpRouteHandler) -> None: ...
+    def serve_static(self, path: str, directory: str) -> None: ...
+    async def start(self, port: int) -> None: ...
+    async def stop(self) -> None: ...
+
+class HttpRouteHandler(Protocol):
+    async def __call__(self, request: HttpRequest) -> HttpResponse: ...
+```
+
+<!-- self-managed -->
+
+```python
+import asyncio
+import uvicorn
+from fastapi import FastAPI
+from microsoft_teams.apps import App, FastAPIAdapter
+
+# 1. Create your FastAPI app with your own routes
+my_fastapi = FastAPI(title="My App + Teams Bot")
+
+@my_fastapi.get("/health")
+async def health():
+    return {"status": "healthy"}
+
+# 2. Wrap it in the FastAPIAdapter
+adapter = FastAPIAdapter(app=my_fastapi)
+
+# 3. Create the Teams app with the adapter
+app = App(http_server_adapter=adapter)
+
+@app.on_message
+async def handle_message(ctx):
+    await ctx.send(f"Echo: {ctx.activity.text}")
+
+async def main():
+    # 4. Initialize — registers /api/messages on your FastAPI app (does NOT start a server)
+    await app.initialize()
+
+    # 5. Start the server yourself
+    config = uvicorn.Config(app=my_fastapi, host="0.0.0.0", port=3978)
+    server = uvicorn.Server(config)
+    await server.serve()
+
+asyncio.run(main())
+```
+
+> See the full example: [FastAPI non-managed example](https://github.com/microsoft/teams.py/tree/main/examples/http-adapters/src/fastapi_non_managed.py)
+
+<!-- custom-adapter -->
+
+Here is a Starlette adapter — only `register_route` is needed:
+
+```python
+from starlette.applications import Starlette
+from starlette.requests import Request
+from starlette.responses import JSONResponse, Response
+from starlette.routing import Route
+from microsoft_teams.apps.http.adapter import HttpMethod, HttpRequest, HttpResponse, HttpRouteHandler
+
+class StarletteAdapter:
+    def __init__(self, app: Starlette):
+        self._app = app
+
+    def register_route(self, method: HttpMethod, path: str, handler: HttpRouteHandler) -> None:
+        # Teams only sends POST requests to your bot endpoint
+        async def starlette_handler(request: Request) -> Response:
+            body = await request.json()
+            headers = dict(request.headers)
+            result: HttpResponse = await handler(HttpRequest(body=body, headers=headers))
+            if result.get("body") is not None:
+                return JSONResponse(content=result["body"], status_code=result["status"])
+            return Response(status_code=result["status"])
+
+        route = Route(path, starlette_handler, methods=[method])
+        self._app.routes.insert(0, route)
+```
+
+Usage:
+
+```python
+starlette_app = Starlette()
+adapter = StarletteAdapter(starlette_app)
+app = App(http_server_adapter=adapter)
+await app.initialize()
+# Start Starlette with uvicorn yourself
+```
+
+> See the full implementation: [Starlette adapter example](https://github.com/microsoft/teams.py/tree/main/examples/http-adapters/src/starlette_adapter.py)

teams.md/src/components/include/in-depth-guides/server/http-server/typescript.incl.md

@@ -0,0 +1,90 @@
+<!-- default-framework -->
+
+[Express](https://expressjs.com/)
+
+<!-- adapter-interface -->
+
+```typescript
+interface IHttpServerAdapter {
+  registerRoute(method: HttpMethod, path: string, handler: HttpRouteHandler): void;
+  serveStatic?(path: string, directory: string): void;
+  start?(port: number): Promise<void>;
+  stop?(): Promise<void>;
+}
+
+type HttpRouteHandler = (request: { body: unknown; headers: Record<string, string | string[]> })
+  => Promise<{ status: number; body?: unknown }>;
+```
+
+<!-- self-managed -->
+
+```typescript
+import http from 'http';
+import express from 'express';
+import { App, ExpressAdapter } from '@microsoft/teams.apps';
+
+// 1. Create your Express app with your own routes
+const expressApp = express();
+const httpServer = http.createServer(expressApp);
+
+expressApp.get('/health', (_req, res) => {
+  res.json({ status: 'healthy' });
+});
+
+// 2. Wrap it in the ExpressAdapter
+const adapter = new ExpressAdapter(httpServer);
+
+// 3. Create the Teams app with the adapter
+const app = new App({ httpServerAdapter: adapter });
+
+app.on('message', async ({ send, activity }) => {
+  await send(`Echo: ${activity.text}`);
+});
+
+// 4. Initialize — registers /api/messages on your Express app (does NOT start a server)
+await app.initialize();
+
+// 5. Start the server yourself
+httpServer.listen(3978, () => console.log('Server ready on http://localhost:3978'));
+```
+
+> See the full [Express adapter example](https://github.com/microsoft/teams.ts/tree/main/examples/http-adapters/express)
+
+<!-- custom-adapter -->
+
+Here is a Restify adapter — only `registerRoute` is needed:
+
+```typescript
+import restify from 'restify';
+import { HttpMethod, IHttpServerAdapter, HttpRouteHandler } from '@microsoft/teams.apps';
+
+class RestifyAdapter implements IHttpServerAdapter {
+  constructor(private server: restify.Server) {
+    this.server.use(restify.plugins.bodyParser());
+  }
+
+  registerRoute(method: HttpMethod, path: string, handler: HttpRouteHandler): void {
+    // Teams only sends POST requests to your bot endpoint
+    assert(method === 'POST', `Unsupported method: ${method}`);
+    this.server.post(path, async (req: restify.Request, res: restify.Response) => {
+      const response = await handler({
+        body: req.body,
+        headers: req.headers as Record<string, string | string[]>,
+      });
+      res.send(response.status, response.body);
+    });
+  }
+}
+```
+
+Usage:
+
+```typescript
+const server = restify.createServer();
+const adapter = new RestifyAdapter(server);
+const app = new App({ httpServerAdapter: adapter });
+await app.initialize();
+server.listen(3978);
+```
+
+> See the full implementation: [Restify adapter example](https://github.com/microsoft/teams.ts/tree/main/examples/http-adapters/restify)

teams.md/src/components/include/essentials/hosting-static-pages/csharp.incl.md → teams.md/src/components/include/in-depth-guides/server/static-pages/csharp.incl.md

@@ -14,5 +14,5 @@ app.AddTab("myApp", "Web/bin");
 
 <!-- additional-resources -->
 
-- For more details about Tab apps, see the [Tabs](../in-depth-guides/tabs/) in-depth guide.
-- For an example of hosting a Dialog, see the [Creating Dialogs](../in-depth-guides/dialogs/creating-dialogs) in-depth guide.
+- For more details about Tab apps, see the [Tabs](../tabs/) in-depth guide.
+- For an example of hosting a Dialog, see the [Creating Dialogs](../dialogs/creating-dialogs) in-depth guide.

teams.md/src/components/include/essentials/hosting-static-pages/python.incl.md → teams.md/src/components/include/in-depth-guides/server/static-pages/python.incl.md

@@ -14,4 +14,4 @@ app.tab("my_app", os.path.abspath("dist/client"))
 
 <!-- additional-resources -->
 
-- For an example of hosting a Dialog, see the [Creating Dialogs](../in-depth-guides/dialogs/creating-dialogs) in-depth guide.
+- For an example of hosting a Dialog, see the [Creating Dialogs](../dialogs/creating-dialogs) in-depth guide.

teams.md/src/components/include/essentials/hosting-static-pages/typescript.incl.md → teams.md/src/components/include/in-depth-guides/server/static-pages/typescript.incl.md

@@ -14,5 +14,5 @@ app.tab('myApp', path.resolve('dist/client'));
 
 <!-- additional-resources -->
 
-- For more details about Tab apps, see the [Tabs](../in-depth-guides/tabs) in-depth guide.
-- For an example of hosting a Dialog, see the [Creating Dialogs](../in-depth-guides/dialogs/creating-dialogs) in-depth guide.
+- For more details about Tab apps, see the [Tabs](../tabs) in-depth guide.
+- For an example of hosting a Dialog, see the [Creating Dialogs](../dialogs/creating-dialogs) in-depth guide.

teams.md/src/components/include/in-depth-guides/tabs/csharp.incl.md

@@ -6,5 +6,5 @@ This SDK does not offer features for implementing Tab apps in C#. It does howeve
 
 ### Additional resources
 
-- [Hosting Apps/Static Pages](../../essentials/hosting-static-pages)
+- [Static Pages](../server/static-pages)
 - [TypeScript Tabs in-depth guide](../../../typescript/in-depth-guides/tabs)

teams.md/src/components/include/in-depth-guides/tabs/typescript.incl.md

@@ -13,4 +13,4 @@ The `@microsoft/teams.client` package in this SDK builds on TeamsJS and MSAL to
 
 ### Additional resources
 
-- [Hosting Apps/Static Pages](../../essentials/hosting-static-pages)
+- [Static Pages](../server/static-pages)

teams.md/src/pages/templates/getting-started/quickstart.mdx

@@ -61,6 +61,20 @@ Now, navigate to the devtools server by opening your browser and navigating to [
 
 ![Screenshot of DevTools showing user prompt 'hello!' and agent response 'you said hello!'.](/screenshots/devtools-echo-chat.png)
 
+## Add to an Existing Project
+
+If you already have a project and want to add Teams support, install the SDK directly:
+
+<LanguageInclude section="manual-install" />
+
+Then initialize the Teams app with your existing server:
+
+<LanguageInclude section="manual-code" />
+
+`app.initialize()` registers the Teams endpoint on your server without starting a new one — you keep full control of your server lifecycle.
+
+<LanguageInclude section="manual-more" />
+
 ## Next steps
 
 After creating and running your first agent, read about [the code basics](code-basics) to better understand its components and structure.

teams.md/src/pages/templates/in-depth-guides/server/_category_.json

@@ -0,0 +1,6 @@
+{
+  "label": "Server",
+  "position": 9,
+  "collapsible": true,
+  "collapsed": true
+}