Skip to content

Commit 1fed009

Browse files
markshustclaude
andcommitted
docs: add MarkoTalk callouts to README, introduction, and chat tutorial
Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
1 parent ac137a0 commit 1fed009

3 files changed

Lines changed: 11 additions & 1 deletion

File tree

README.md

Lines changed: 6 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -321,6 +321,12 @@ Marko ships as composable packages — require only what you need. Every package
321321
|---------|-------------|
322322
| [testing](packages/testing/README.md) | Test fakes, assertions, and Pest expectations |
323323

324+
## Example Applications
325+
326+
| App | Description |
327+
|-----|-------------|
328+
| [MarkoTalk](https://github.com/marko-php/markotalk) | Real-time community chat — dogfoods plugins, preferences, events, SSE, and the admin panel |
329+
324330
## Requirements
325331

326332
- PHP 8.5+

docs/src/content/docs/getting-started/introduction.md

Lines changed: 4 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -48,6 +48,10 @@ marko/cache-redis → RedisCacheDriver (Redis implementation)
4848

4949
You code against the interface. Swap implementations by changing a single binding — no other code changes needed.
5050

51+
## See It in Action
52+
53+
[MarkoTalk](https://github.com/marko-php/markotalk) is a real-time community chat app built with Marko. It dogfoods the framework's module system, plugins, preferences, events, SSE, and admin panel in a production-quality application. It's the best way to see how everything fits together.
54+
5155
## What's Next?
5256

5357
- [Install Marko](/docs/getting-started/installation/) and create your first project

docs/src/content/docs/tutorials/build-a-chat.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -448,7 +448,7 @@ The replay loop creates `SseEvent` objects with explicit `id` values. When the b
448448
marko up
449449
```
450450

451-
`marko up` (alias for `dev:up`) starts the full development environment automatically --- PHP server, Docker if detected, pub/sub listener if pubsub packages are installed, and frontend build tools if detected. For SSE applications this is important: `marko up` starts PHP with `PHP_CLI_SERVER_WORKERS=4` by default, so the SSE connection does not block all other requests on the single-threaded PHP built-in server. MarkoTalk (the reference chat implementation) uses this same approach.
451+
`marko up` (alias for `dev:up`) starts the full development environment automatically --- PHP server, Docker if detected, pub/sub listener if pubsub packages are installed, and frontend build tools if detected. For SSE applications this is important: `marko up` starts PHP with `PHP_CLI_SERVER_WORKERS=4` by default, so the SSE connection does not block all other requests on the single-threaded PHP built-in server. [MarkoTalk](https://github.com/marko-php/markotalk) (the reference chat implementation) uses this same approach.
452452

453453
In separate terminals, test the flow:
454454

0 commit comments

Comments
 (0)