@mohammadhprp/system-prompt 0.10.1
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/LICENSE +21 -0
- package/README.md +35 -0
- package/bin/system-prompt.js +8 -0
- package/framework/README.md +163 -0
- package/framework/agents/README.md +49 -0
- package/framework/agents/backend-architect.md +146 -0
- package/framework/agents/researcher.md +79 -0
- package/framework/agents/reviewer.md +183 -0
- package/framework/agents/security-auditor.md +131 -0
- package/framework/commands/README.md +43 -0
- package/framework/commands/changelog.md +44 -0
- package/framework/commands/commit.md +31 -0
- package/framework/commands/learn.md +24 -0
- package/framework/commands/mr.md +46 -0
- package/framework/commands/pr.md +39 -0
- package/framework/commands/release.md +34 -0
- package/framework/commands/review.md +24 -0
- package/framework/commands/summarize-changes.md +49 -0
- package/framework/mcps/README.md +78 -0
- package/framework/mcps/excalidraw/README.md +37 -0
- package/framework/mcps/excalidraw/capabilities.md +54 -0
- package/framework/mcps/excalidraw/configs/opencode.json +8 -0
- package/framework/mcps/excalidraw/install.md +92 -0
- package/framework/mcps/excalidraw/troubleshooting.md +67 -0
- package/framework/mcps/figma-mcp-go/README.md +51 -0
- package/framework/mcps/figma-mcp-go/capabilities.md +190 -0
- package/framework/mcps/figma-mcp-go/configs/opencode.json +9 -0
- package/framework/mcps/figma-mcp-go/install.md +74 -0
- package/framework/mcps/figma-mcp-go/troubleshooting.md +99 -0
- package/framework/mcps/github-mcp/README.md +51 -0
- package/framework/mcps/github-mcp/capabilities.md +83 -0
- package/framework/mcps/github-mcp/configs/.env.example +1 -0
- package/framework/mcps/github-mcp/configs/opencode.json +13 -0
- package/framework/mcps/github-mcp/install.md +60 -0
- package/framework/mcps/github-mcp/troubleshooting.md +79 -0
- package/framework/mcps/gitlab-mcp/README.md +54 -0
- package/framework/mcps/gitlab-mcp/capabilities.md +216 -0
- package/framework/mcps/gitlab-mcp/configs/.env.example +2 -0
- package/framework/mcps/gitlab-mcp/configs/opencode.json +13 -0
- package/framework/mcps/gitlab-mcp/install.md +99 -0
- package/framework/mcps/gitlab-mcp/troubleshooting.md +116 -0
- package/framework/mcps/jira-mcp/README.md +53 -0
- package/framework/mcps/jira-mcp/capabilities.md +79 -0
- package/framework/mcps/jira-mcp/configs/.env.example +2 -0
- package/framework/mcps/jira-mcp/configs/opencode.json +13 -0
- package/framework/mcps/jira-mcp/install.md +94 -0
- package/framework/mcps/jira-mcp/troubleshooting.md +113 -0
- package/framework/mcps/laravel-boost/README.md +53 -0
- package/framework/mcps/laravel-boost/capabilities.md +92 -0
- package/framework/mcps/laravel-boost/configs/opencode.json +9 -0
- package/framework/mcps/laravel-boost/install.md +106 -0
- package/framework/mcps/laravel-boost/troubleshooting.md +119 -0
- package/framework/mcps/notion-mcp/README.md +58 -0
- package/framework/mcps/notion-mcp/capabilities.md +118 -0
- package/framework/mcps/notion-mcp/configs/opencode.json +9 -0
- package/framework/mcps/notion-mcp/install.md +70 -0
- package/framework/mcps/notion-mcp/troubleshooting.md +95 -0
- package/framework/mcps/playwright-mcp/README.md +50 -0
- package/framework/mcps/playwright-mcp/capabilities.md +149 -0
- package/framework/mcps/playwright-mcp/configs/opencode.json +9 -0
- package/framework/mcps/playwright-mcp/install.md +136 -0
- package/framework/mcps/playwright-mcp/troubleshooting.md +154 -0
- package/framework/mcps/supabase-mcp/README.md +66 -0
- package/framework/mcps/supabase-mcp/capabilities.md +127 -0
- package/framework/mcps/supabase-mcp/configs/opencode.json +9 -0
- package/framework/mcps/supabase-mcp/install.md +85 -0
- package/framework/mcps/supabase-mcp/troubleshooting.md +113 -0
- package/framework/memory/README.md +17 -0
- package/framework/memory/codebase-insights.md +6 -0
- package/framework/memory/user-preferences.md +5 -0
- package/framework/modes/README.md +52 -0
- package/framework/modes/audit.md +88 -0
- package/framework/plugins/README.md +65 -0
- package/framework/plugins/opencode-goal-plugin/README.md +45 -0
- package/framework/plugins/opencode-goal-plugin/capabilities.md +127 -0
- package/framework/plugins/opencode-goal-plugin/install.md +71 -0
- package/framework/plugins/opencode-goal-plugin/troubleshooting.md +112 -0
- package/framework/plugins/ponytail/README.md +44 -0
- package/framework/plugins/ponytail/capabilities.md +112 -0
- package/framework/plugins/ponytail/install.md +77 -0
- package/framework/plugins/ponytail/troubleshooting.md +116 -0
- package/framework/references/standards/api.md +44 -0
- package/framework/references/standards/architecture.md +43 -0
- package/framework/references/standards/database.md +43 -0
- package/framework/references/standards/debugging.md +44 -0
- package/framework/references/standards/documentation.md +43 -0
- package/framework/references/standards/logging.md +43 -0
- package/framework/references/standards/naming.md +43 -0
- package/framework/references/standards/observability.md +43 -0
- package/framework/references/standards/performance.md +43 -0
- package/framework/references/standards/pull-requests.md +43 -0
- package/framework/references/standards/security.md +43 -0
- package/framework/references/standards/testing.md +43 -0
- package/framework/references/templates/adr.md +28 -0
- package/framework/references/templates/api-spec.md +56 -0
- package/framework/references/templates/design-document.md +39 -0
- package/framework/references/templates/incident-report.md +38 -0
- package/framework/references/templates/postmortem.md +41 -0
- package/framework/references/templates/pull-request.md +34 -0
- package/framework/references/templates/runbook.md +48 -0
- package/framework/references/templates/task.md +27 -0
- package/framework/skills/README.md +68 -0
- package/framework/skills/agent-browser/SKILL.md +51 -0
- package/framework/skills/backend-best-practices/SKILL.md +136 -0
- package/framework/skills/backend-best-practices/examples.md +31 -0
- package/framework/skills/backend-best-practices/references/api-design.md +79 -0
- package/framework/skills/backend-best-practices/references/architecture-review.md +77 -0
- package/framework/skills/backend-best-practices/references/database-design.md +78 -0
- package/framework/skills/backend-best-practices/references/debugging.md +76 -0
- package/framework/skills/backend-best-practices/references/observability.md +78 -0
- package/framework/skills/backend-best-practices/references/performance.md +78 -0
- package/framework/skills/backend-best-practices/references/refactoring.md +77 -0
- package/framework/skills/backend-best-practices/references/security.md +80 -0
- package/framework/skills/backend-best-practices/references/testing.md +77 -0
- package/framework/skills/backend-engineer/SKILL.md +76 -0
- package/framework/skills/backend-engineer/examples.md +31 -0
- package/framework/skills/brainstorming/SKILL.md +159 -0
- package/framework/skills/brainstorming/examples.md +49 -0
- package/framework/skills/brainstorming/scripts/frame-template.html +213 -0
- package/framework/skills/brainstorming/scripts/helper.js +167 -0
- package/framework/skills/brainstorming/scripts/server.cjs +723 -0
- package/framework/skills/brainstorming/scripts/start-server.sh +209 -0
- package/framework/skills/brainstorming/scripts/stop-server.sh +120 -0
- package/framework/skills/brainstorming/visual-companion.md +291 -0
- package/framework/skills/brand-guidelines/LICENSE.txt +202 -0
- package/framework/skills/brand-guidelines/SKILL.md +73 -0
- package/framework/skills/code-review/SKILL.md +72 -0
- package/framework/skills/code-review/examples.md +31 -0
- package/framework/skills/design/SKILL.md +399 -0
- package/framework/skills/design/examples.md +34 -0
- package/framework/skills/diagram-design/SKILL.md +485 -0
- package/framework/skills/diagram-design/assets/example-architecture-dark.html +180 -0
- package/framework/skills/diagram-design/assets/example-architecture-full.html +192 -0
- package/framework/skills/diagram-design/assets/example-architecture.html +181 -0
- package/framework/skills/diagram-design/assets/example-bar-dark.html +127 -0
- package/framework/skills/diagram-design/assets/example-bar-full.html +103 -0
- package/framework/skills/diagram-design/assets/example-bar.html +127 -0
- package/framework/skills/diagram-design/assets/example-data-flow-dark.html +143 -0
- package/framework/skills/diagram-design/assets/example-data-flow-full.html +185 -0
- package/framework/skills/diagram-design/assets/example-data-flow.html +143 -0
- package/framework/skills/diagram-design/assets/example-datalake-dark.html +241 -0
- package/framework/skills/diagram-design/assets/example-datalake-full.html +246 -0
- package/framework/skills/diagram-design/assets/example-datalake.html +267 -0
- package/framework/skills/diagram-design/assets/example-dp-integration-dark.html +78 -0
- package/framework/skills/diagram-design/assets/example-dp-integration-full.html +88 -0
- package/framework/skills/diagram-design/assets/example-dp-integration.html +78 -0
- package/framework/skills/diagram-design/assets/example-dp-security-matrix-dark.html +31 -0
- package/framework/skills/diagram-design/assets/example-dp-security-matrix-full.html +32 -0
- package/framework/skills/diagram-design/assets/example-dp-security-matrix.html +88 -0
- package/framework/skills/diagram-design/assets/example-er-dark.html +200 -0
- package/framework/skills/diagram-design/assets/example-er-full.html +203 -0
- package/framework/skills/diagram-design/assets/example-er.html +200 -0
- package/framework/skills/diagram-design/assets/example-flowchart-dark.html +154 -0
- package/framework/skills/diagram-design/assets/example-flowchart-full.html +157 -0
- package/framework/skills/diagram-design/assets/example-flowchart.html +154 -0
- package/framework/skills/diagram-design/assets/example-gantt-dark.html +135 -0
- package/framework/skills/diagram-design/assets/example-gantt-full.html +125 -0
- package/framework/skills/diagram-design/assets/example-gantt.html +135 -0
- package/framework/skills/diagram-design/assets/example-high-level-dark.html +249 -0
- package/framework/skills/diagram-design/assets/example-high-level-full.html +245 -0
- package/framework/skills/diagram-design/assets/example-high-level-vertical-dark.html +272 -0
- package/framework/skills/diagram-design/assets/example-high-level-vertical-full.html +250 -0
- package/framework/skills/diagram-design/assets/example-high-level-vertical.html +323 -0
- package/framework/skills/diagram-design/assets/example-high-level.html +299 -0
- package/framework/skills/diagram-design/assets/example-it-state-dark.html +90 -0
- package/framework/skills/diagram-design/assets/example-it-state-full.html +69 -0
- package/framework/skills/diagram-design/assets/example-it-state.html +128 -0
- package/framework/skills/diagram-design/assets/example-layers-dark.html +121 -0
- package/framework/skills/diagram-design/assets/example-layers-full.html +124 -0
- package/framework/skills/diagram-design/assets/example-layers.html +121 -0
- package/framework/skills/diagram-design/assets/example-line-dark.html +109 -0
- package/framework/skills/diagram-design/assets/example-line-full.html +103 -0
- package/framework/skills/diagram-design/assets/example-line.html +109 -0
- package/framework/skills/diagram-design/assets/example-loop-dark.html +100 -0
- package/framework/skills/diagram-design/assets/example-loop-full.html +137 -0
- package/framework/skills/diagram-design/assets/example-loop-terminal.html +347 -0
- package/framework/skills/diagram-design/assets/example-loop.html +100 -0
- package/framework/skills/diagram-design/assets/example-medallion-dark.html +159 -0
- package/framework/skills/diagram-design/assets/example-medallion-full.html +201 -0
- package/framework/skills/diagram-design/assets/example-medallion.html +159 -0
- package/framework/skills/diagram-design/assets/example-nested-dark.html +130 -0
- package/framework/skills/diagram-design/assets/example-nested-full.html +133 -0
- package/framework/skills/diagram-design/assets/example-nested.html +134 -0
- package/framework/skills/diagram-design/assets/example-org-chart-dark.html +45 -0
- package/framework/skills/diagram-design/assets/example-org-chart-full.html +45 -0
- package/framework/skills/diagram-design/assets/example-org-chart.html +45 -0
- package/framework/skills/diagram-design/assets/example-process-dark.html +62 -0
- package/framework/skills/diagram-design/assets/example-process-full.html +72 -0
- package/framework/skills/diagram-design/assets/example-process.html +62 -0
- package/framework/skills/diagram-design/assets/example-pyramid-dark.html +117 -0
- package/framework/skills/diagram-design/assets/example-pyramid-full.html +120 -0
- package/framework/skills/diagram-design/assets/example-pyramid.html +117 -0
- package/framework/skills/diagram-design/assets/example-quadrant-consultant.html +164 -0
- package/framework/skills/diagram-design/assets/example-quadrant-dark.html +133 -0
- package/framework/skills/diagram-design/assets/example-quadrant-full.html +136 -0
- package/framework/skills/diagram-design/assets/example-quadrant.html +133 -0
- package/framework/skills/diagram-design/assets/example-radar-dark.html +137 -0
- package/framework/skills/diagram-design/assets/example-radar-full.html +133 -0
- package/framework/skills/diagram-design/assets/example-radar.html +137 -0
- package/framework/skills/diagram-design/assets/example-scatter-dark.html +139 -0
- package/framework/skills/diagram-design/assets/example-scatter-full.html +114 -0
- package/framework/skills/diagram-design/assets/example-scatter.html +139 -0
- package/framework/skills/diagram-design/assets/example-sequence-dark.html +220 -0
- package/framework/skills/diagram-design/assets/example-sequence-full.html +386 -0
- package/framework/skills/diagram-design/assets/example-sequence.html +220 -0
- package/framework/skills/diagram-design/assets/example-state-dark.html +145 -0
- package/framework/skills/diagram-design/assets/example-state-full.html +148 -0
- package/framework/skills/diagram-design/assets/example-state.html +145 -0
- package/framework/skills/diagram-design/assets/example-swimlane-dark.html +170 -0
- package/framework/skills/diagram-design/assets/example-swimlane-full.html +173 -0
- package/framework/skills/diagram-design/assets/example-swimlane.html +170 -0
- package/framework/skills/diagram-design/assets/example-timeline-dark.html +133 -0
- package/framework/skills/diagram-design/assets/example-timeline-full.html +136 -0
- package/framework/skills/diagram-design/assets/example-timeline.html +133 -0
- package/framework/skills/diagram-design/assets/example-tree-dark.html +171 -0
- package/framework/skills/diagram-design/assets/example-tree-full.html +174 -0
- package/framework/skills/diagram-design/assets/example-tree.html +171 -0
- package/framework/skills/diagram-design/assets/example-venn-dark.html +130 -0
- package/framework/skills/diagram-design/assets/example-venn-full.html +133 -0
- package/framework/skills/diagram-design/assets/example-venn.html +108 -0
- package/framework/skills/diagram-design/assets/icons.html +230 -0
- package/framework/skills/diagram-design/assets/index.html +333 -0
- package/framework/skills/diagram-design/assets/template-dark.html +82 -0
- package/framework/skills/diagram-design/assets/template-full.html +410 -0
- package/framework/skills/diagram-design/assets/template-terminal.html +170 -0
- package/framework/skills/diagram-design/assets/template.html +83 -0
- package/framework/skills/diagram-design/references/export.md +107 -0
- package/framework/skills/diagram-design/references/onboarding.md +268 -0
- package/framework/skills/diagram-design/references/primitive-annotation.md +36 -0
- package/framework/skills/diagram-design/references/primitive-icons.md +821 -0
- package/framework/skills/diagram-design/references/primitive-sketchy.md +43 -0
- package/framework/skills/diagram-design/references/primitive-terminal.md +76 -0
- package/framework/skills/diagram-design/references/style-guide.md +139 -0
- package/framework/skills/diagram-design/references/type-architecture.md +78 -0
- package/framework/skills/diagram-design/references/type-bar.md +48 -0
- package/framework/skills/diagram-design/references/type-data-flow.md +374 -0
- package/framework/skills/diagram-design/references/type-dp-integration.md +410 -0
- package/framework/skills/diagram-design/references/type-dp-security-matrix.md +379 -0
- package/framework/skills/diagram-design/references/type-er.md +23 -0
- package/framework/skills/diagram-design/references/type-flowchart.md +23 -0
- package/framework/skills/diagram-design/references/type-gantt.md +45 -0
- package/framework/skills/diagram-design/references/type-high-level.md +458 -0
- package/framework/skills/diagram-design/references/type-it-state.md +470 -0
- package/framework/skills/diagram-design/references/type-layers.md +26 -0
- package/framework/skills/diagram-design/references/type-line.md +44 -0
- package/framework/skills/diagram-design/references/type-loop.md +223 -0
- package/framework/skills/diagram-design/references/type-medallion.md +356 -0
- package/framework/skills/diagram-design/references/type-nested.md +22 -0
- package/framework/skills/diagram-design/references/type-org-chart.md +44 -0
- package/framework/skills/diagram-design/references/type-process.md +495 -0
- package/framework/skills/diagram-design/references/type-pyramid.md +33 -0
- package/framework/skills/diagram-design/references/type-quadrant.md +81 -0
- package/framework/skills/diagram-design/references/type-radar.md +80 -0
- package/framework/skills/diagram-design/references/type-scatter.md +39 -0
- package/framework/skills/diagram-design/references/type-sequence.md +35 -0
- package/framework/skills/diagram-design/references/type-state.md +21 -0
- package/framework/skills/diagram-design/references/type-swimlane.md +20 -0
- package/framework/skills/diagram-design/references/type-timeline.md +20 -0
- package/framework/skills/diagram-design/references/type-tree.md +24 -0
- package/framework/skills/diagram-design/references/type-venn.md +26 -0
- package/framework/skills/documentation/SKILL.md +74 -0
- package/framework/skills/documentation/examples.md +31 -0
- package/framework/skills/find-skills/SKILL.md +141 -0
- package/framework/skills/find-skills/examples.md +35 -0
- package/framework/skills/gitlab-mcp/SKILL.md +83 -0
- package/framework/skills/gitlab-mcp/examples.md +31 -0
- package/framework/skills/gitlab-mcp/references/code-review.md +110 -0
- package/framework/skills/gitlab-mcp/references/issues.md +141 -0
- package/framework/skills/gitlab-mcp/references/merge-requests.md +120 -0
- package/framework/skills/gitlab-mcp/references/pipelines.md +67 -0
- package/framework/skills/gitlab-mcp/references/search.md +17 -0
- package/framework/skills/gitlab-mcp/references/webhooks.md +32 -0
- package/framework/skills/gitlab-mcp/references/work-items.md +50 -0
- package/framework/skills/jira-mcp/SKILL.md +57 -0
- package/framework/skills/jira-mcp/examples.md +31 -0
- package/framework/skills/jira-mcp/references/comments.md +27 -0
- package/framework/skills/jira-mcp/references/issues.md +97 -0
- package/framework/skills/jira-mcp/references/projects.md +39 -0
- package/framework/skills/laravel-best-practices/SKILL.md +229 -0
- package/framework/skills/laravel-best-practices/examples.md +31 -0
- package/framework/skills/laravel-best-practices/references/advanced-queries.md +106 -0
- package/framework/skills/laravel-best-practices/references/architecture.md +202 -0
- package/framework/skills/laravel-best-practices/references/blade-views.md +36 -0
- package/framework/skills/laravel-best-practices/references/caching.md +70 -0
- package/framework/skills/laravel-best-practices/references/collections.md +44 -0
- package/framework/skills/laravel-best-practices/references/config.md +73 -0
- package/framework/skills/laravel-best-practices/references/db-performance.md +192 -0
- package/framework/skills/laravel-best-practices/references/eloquent.md +148 -0
- package/framework/skills/laravel-best-practices/references/error-handling.md +72 -0
- package/framework/skills/laravel-best-practices/references/events-notifications.md +52 -0
- package/framework/skills/laravel-best-practices/references/http-client.md +160 -0
- package/framework/skills/laravel-best-practices/references/mail.md +27 -0
- package/framework/skills/laravel-best-practices/references/migrations.md +121 -0
- package/framework/skills/laravel-best-practices/references/passport.md +197 -0
- package/framework/skills/laravel-best-practices/references/pennant.md +61 -0
- package/framework/skills/laravel-best-practices/references/pest-testing.md +166 -0
- package/framework/skills/laravel-best-practices/references/pulse.md +196 -0
- package/framework/skills/laravel-best-practices/references/queue-jobs.md +144 -0
- package/framework/skills/laravel-best-practices/references/routing.md +99 -0
- package/framework/skills/laravel-best-practices/references/scheduling.md +39 -0
- package/framework/skills/laravel-best-practices/references/scout.md +176 -0
- package/framework/skills/laravel-best-practices/references/security.md +198 -0
- package/framework/skills/laravel-best-practices/references/spatie-laravel-backup.md +222 -0
- package/framework/skills/laravel-best-practices/references/spatie-laravel-permission.md +272 -0
- package/framework/skills/laravel-best-practices/references/spatie-medialibrary.md +672 -0
- package/framework/skills/laravel-best-practices/references/style.md +125 -0
- package/framework/skills/laravel-best-practices/references/tailwindcss.md +112 -0
- package/framework/skills/laravel-best-practices/references/testing.md +43 -0
- package/framework/skills/laravel-best-practices/references/validation.md +75 -0
- package/framework/skills/lavish/SKILL.md +67 -0
- package/framework/skills/lavish/examples.md +31 -0
- package/framework/skills/notion-mcp/SKILL.md +57 -0
- package/framework/skills/notion-mcp/examples.md +31 -0
- package/framework/skills/notion-mcp/references/comments.md +112 -0
- package/framework/skills/notion-mcp/references/databases.md +193 -0
- package/framework/skills/notion-mcp/references/pages.md +235 -0
- package/framework/skills/skill-creator/LICENSE.txt +202 -0
- package/framework/skills/skill-creator/SKILL.md +485 -0
- package/framework/skills/skill-creator/agents/analyzer.md +274 -0
- package/framework/skills/skill-creator/agents/comparator.md +202 -0
- package/framework/skills/skill-creator/agents/grader.md +223 -0
- package/framework/skills/skill-creator/assets/eval_review.html +146 -0
- package/framework/skills/skill-creator/eval-viewer/generate_review.py +471 -0
- package/framework/skills/skill-creator/eval-viewer/viewer.html +1325 -0
- package/framework/skills/skill-creator/examples.md +31 -0
- package/framework/skills/skill-creator/references/schemas.md +430 -0
- package/framework/skills/skill-creator/scripts/__init__.py +0 -0
- package/framework/skills/skill-creator/scripts/aggregate_benchmark.py +401 -0
- package/framework/skills/skill-creator/scripts/generate_report.py +326 -0
- package/framework/skills/skill-creator/scripts/improve_description.py +247 -0
- package/framework/skills/skill-creator/scripts/package_skill.py +136 -0
- package/framework/skills/skill-creator/scripts/quick_validate.py +103 -0
- package/framework/skills/skill-creator/scripts/run_eval.py +310 -0
- package/framework/skills/skill-creator/scripts/run_loop.py +328 -0
- package/framework/skills/skill-creator/scripts/utils.py +47 -0
- package/framework/styles/README.md +35 -0
- package/framework/styles/linear/DESIGN.md +478 -0
- package/framework/styles/linear/README.md +36 -0
- package/framework/styles/linear/assets/preview.jpg +0 -0
- package/framework/styles/raycast/DESIGN.md +495 -0
- package/framework/styles/raycast/README.md +35 -0
- package/framework/styles/raycast/assets/preview.jpg +0 -0
- package/package.json +33 -0
- package/src/agent-configs.js +96 -0
- package/src/catalog.js +145 -0
- package/src/cli.js +254 -0
- package/src/installer.js +303 -0
|
@@ -0,0 +1,220 @@
|
|
|
1
|
+
<!DOCTYPE html>
|
|
2
|
+
<html lang="en">
|
|
3
|
+
<head>
|
|
4
|
+
<meta charset="UTF-8">
|
|
5
|
+
<meta name="viewport" content="width=device-width, initial-scale=1.0">
|
|
6
|
+
<title>Article request · Sequence</title>
|
|
7
|
+
<link href="https://fonts.googleapis.com/css2?family=Instrument+Serif:ital@0;1&family=Geist:wght@400;500;600&family=Geist+Mono:wght@400;500;600&display=swap" rel="stylesheet">
|
|
8
|
+
<style>
|
|
9
|
+
*, *::before, *::after { box-sizing: border-box; margin: 0; padding: 0; }
|
|
10
|
+
:root {
|
|
11
|
+
--color-paper: #2d3142;
|
|
12
|
+
--color-ink: #f5f5f5;
|
|
13
|
+
--color-muted: #bfc0c0;
|
|
14
|
+
--color-accent: #f08a59;
|
|
15
|
+
--font-sans: 'Geist', system-ui, sans-serif;
|
|
16
|
+
--font-serif: 'Instrument Serif', serif;
|
|
17
|
+
--font-mono: 'Geist Mono', ui-monospace, monospace;
|
|
18
|
+
}
|
|
19
|
+
|
|
20
|
+
body {
|
|
21
|
+
font-family: var(--font-sans);
|
|
22
|
+
background: var(--color-paper);
|
|
23
|
+
color: var(--color-ink);
|
|
24
|
+
min-height: 100vh;
|
|
25
|
+
display: flex;
|
|
26
|
+
align-items: center;
|
|
27
|
+
justify-content: center;
|
|
28
|
+
padding: 3rem 2rem;
|
|
29
|
+
}
|
|
30
|
+
|
|
31
|
+
.frame { max-width: 1200px; width: 100%; }
|
|
32
|
+
|
|
33
|
+
.eyebrow {
|
|
34
|
+
font-family: var(--font-mono);
|
|
35
|
+
font-size: 0.66rem;
|
|
36
|
+
font-weight: 500;
|
|
37
|
+
letter-spacing: 0.18em;
|
|
38
|
+
text-transform: uppercase;
|
|
39
|
+
color: var(--color-muted);
|
|
40
|
+
margin-bottom: 0.5rem;
|
|
41
|
+
}
|
|
42
|
+
|
|
43
|
+
h1 {
|
|
44
|
+
font-family: var(--font-serif);
|
|
45
|
+
font-size: clamp(1.5rem, 2.4vw + 0.75rem, 2rem);
|
|
46
|
+
font-weight: 400;
|
|
47
|
+
letter-spacing: -0.02em;
|
|
48
|
+
line-height: 1.15;
|
|
49
|
+
color: var(--color-ink);
|
|
50
|
+
margin-bottom: 1.5rem;
|
|
51
|
+
}
|
|
52
|
+
|
|
53
|
+
svg { width: 100%; min-width: 900px; display: block; }
|
|
54
|
+
</style>
|
|
55
|
+
</head>
|
|
56
|
+
<body>
|
|
57
|
+
<div class="frame">
|
|
58
|
+
<p class="eyebrow">Sequence · Diagram Design</p>
|
|
59
|
+
<h1>Article request, cold cache</h1>
|
|
60
|
+
|
|
61
|
+
<svg viewBox="0 0 1000 584" xmlns="http://www.w3.org/2000/svg">
|
|
62
|
+
<defs>
|
|
63
|
+
<!-- Dot grid background -->
|
|
64
|
+
<pattern id="dots" width="22" height="22" patternUnits="userSpaceOnUse">
|
|
65
|
+
<circle cx="1" cy="1" r="0.9" fill="rgba(245,245,245,0.10)"/>
|
|
66
|
+
</pattern>
|
|
67
|
+
|
|
68
|
+
<!-- Arrow markers -->
|
|
69
|
+
<marker id="arrow" markerWidth="8" markerHeight="6" refX="7" refY="3" orient="auto">
|
|
70
|
+
<polygon points="0 0, 8 3, 0 6" fill="#bfc0c0"/>
|
|
71
|
+
</marker>
|
|
72
|
+
<marker id="arrow-accent" markerWidth="8" markerHeight="6" refX="7" refY="3" orient="auto">
|
|
73
|
+
<polygon points="0 0, 8 3, 0 6" fill="#f08a59"/>
|
|
74
|
+
</marker>
|
|
75
|
+
<marker id="arrow-link" markerWidth="8" markerHeight="6" refX="7" refY="3" orient="auto">
|
|
76
|
+
<polygon points="0 0, 8 3, 0 6" fill="#6a95d8"/>
|
|
77
|
+
</marker>
|
|
78
|
+
</defs>
|
|
79
|
+
|
|
80
|
+
<!-- Background: paper + dot grid -->
|
|
81
|
+
<rect width="100%" height="100%" fill="#2d3142"/>
|
|
82
|
+
<rect width="100%" height="100%" fill="url(#dots)" opacity="0.55"/>
|
|
83
|
+
|
|
84
|
+
<!-- =================================================================
|
|
85
|
+
LIFELINES — dashed vertical lines from each actor, behind everything.
|
|
86
|
+
Actor lifeline x-coords: 128, 352, 584, 800
|
|
87
|
+
================================================================= -->
|
|
88
|
+
<line x1="128" y1="128" x2="128" y2="488" stroke="rgba(245,245,245,0.22)" stroke-width="1" stroke-dasharray="3,3"/>
|
|
89
|
+
<line x1="352" y1="128" x2="352" y2="488" stroke="rgba(245,245,245,0.22)" stroke-width="1" stroke-dasharray="3,3"/>
|
|
90
|
+
<line x1="584" y1="128" x2="584" y2="488" stroke="rgba(245,245,245,0.22)" stroke-width="1" stroke-dasharray="3,3"/>
|
|
91
|
+
<line x1="800" y1="128" x2="800" y2="488" stroke="rgba(245,245,245,0.22)" stroke-width="1" stroke-dasharray="3,3"/>
|
|
92
|
+
|
|
93
|
+
<!-- =================================================================
|
|
94
|
+
ACTIVATION BARS — w=8 rects on lifelines showing control duration.
|
|
95
|
+
Drawn before message arrows so arrows land on their edges.
|
|
96
|
+
================================================================= -->
|
|
97
|
+
<!-- Cloudflare activation: receives at y=176, responds at y=408 -->
|
|
98
|
+
<rect x="348" y="180" width="8" height="232" fill="rgba(245,245,245,0.06)" stroke="#bfc0c0" stroke-width="0.8"/>
|
|
99
|
+
<!-- Astro activation: called at y=232, returns at y=352 -->
|
|
100
|
+
<rect x="580" y="236" width="8" height="120" fill="rgba(245,245,245,0.06)" stroke="#bfc0c0" stroke-width="0.8"/>
|
|
101
|
+
|
|
102
|
+
<!-- =================================================================
|
|
103
|
+
MESSAGE ARROWS — time flows top→down.
|
|
104
|
+
Draw before labels so label masks cover the line.
|
|
105
|
+
================================================================= -->
|
|
106
|
+
|
|
107
|
+
<!-- M1: Reader → Cloudflare (HTTPS request · link-blue) -->
|
|
108
|
+
<line x1="128" y1="176" x2="352" y2="176" stroke="#6a95d8" stroke-width="1.2" marker-end="url(#arrow-link)"/>
|
|
109
|
+
|
|
110
|
+
<!-- M2: Cloudflare → Astro (cache miss · muted) -->
|
|
111
|
+
<line x1="352" y1="232" x2="580" y2="232" stroke="#bfc0c0" stroke-width="1.2" marker-end="url(#arrow)"/>
|
|
112
|
+
|
|
113
|
+
<!-- M3: Astro self-message (render MDX · muted U-loop) -->
|
|
114
|
+
<path d="M 588 284 L 624 284 L 624 316 L 588 316" fill="none" stroke="#bfc0c0" stroke-width="1.2" marker-end="url(#arrow)"/>
|
|
115
|
+
|
|
116
|
+
<!-- M4: Astro → Cloudflare (return HTML · muted dashed) -->
|
|
117
|
+
<line x1="580" y1="352" x2="356" y2="352" stroke="#bfc0c0" stroke-width="1.2" stroke-dasharray="5,4" marker-end="url(#arrow)"/>
|
|
118
|
+
|
|
119
|
+
<!-- M5: Cloudflare → Reader (primary success · coral) -->
|
|
120
|
+
<line x1="348" y1="408" x2="128" y2="408" stroke="#f08a59" stroke-width="1.4" marker-end="url(#arrow-accent)"/>
|
|
121
|
+
|
|
122
|
+
<!-- M6: Reader → Analytics (async beacon · muted dashed) -->
|
|
123
|
+
<line x1="128" y1="464" x2="800" y2="464" stroke="#bfc0c0" stroke-width="1.2" stroke-dasharray="5,4" marker-end="url(#arrow)"/>
|
|
124
|
+
|
|
125
|
+
<!-- =================================================================
|
|
126
|
+
MESSAGE LABELS — each with an opaque paper-colored mask.
|
|
127
|
+
================================================================= -->
|
|
128
|
+
|
|
129
|
+
<!-- M1 label -->
|
|
130
|
+
<rect x="188" y="160" width="104" height="12" rx="2" fill="#2d3142"/>
|
|
131
|
+
<text x="240" y="170" fill="#6a95d8" font-size="8" font-family="'Geist Mono', monospace" text-anchor="middle" letter-spacing="0.08em">GET /ARTICLES/SLUG</text>
|
|
132
|
+
|
|
133
|
+
<!-- M2 label -->
|
|
134
|
+
<rect x="416" y="216" width="100" height="12" rx="2" fill="#2d3142"/>
|
|
135
|
+
<text x="466" y="226" fill="#bfc0c0" font-size="8" font-family="'Geist Mono', monospace" text-anchor="middle" letter-spacing="0.08em">CACHE MISS · ORIGIN</text>
|
|
136
|
+
|
|
137
|
+
<!-- M3 label (to the right of the self-loop) -->
|
|
138
|
+
<rect x="632" y="292" width="72" height="12" rx="2" fill="#2d3142"/>
|
|
139
|
+
<text x="668" y="302" fill="#bfc0c0" font-size="8" font-family="'Geist Mono', monospace" text-anchor="middle" letter-spacing="0.08em">RENDER MDX</text>
|
|
140
|
+
|
|
141
|
+
<!-- M4 label -->
|
|
142
|
+
<rect x="420" y="336" width="96" height="12" rx="2" fill="#2d3142"/>
|
|
143
|
+
<text x="468" y="346" fill="#bfc0c0" font-size="8" font-family="'Geist Mono', monospace" text-anchor="middle" letter-spacing="0.08em">200 · HTML + MAX-AGE</text>
|
|
144
|
+
|
|
145
|
+
<!-- M5 label (coral · primary response) -->
|
|
146
|
+
<rect x="192" y="392" width="96" height="12" rx="2" fill="#2d3142"/>
|
|
147
|
+
<text x="240" y="402" fill="#f08a59" font-size="8" font-family="'Geist Mono', monospace" text-anchor="middle" letter-spacing="0.08em">200 · EDGE-CACHED</text>
|
|
148
|
+
|
|
149
|
+
<!-- M6 label (placed between Astro and Analytics lifelines, a clear gap) -->
|
|
150
|
+
<rect x="648" y="448" width="96" height="12" rx="2" fill="#2d3142"/>
|
|
151
|
+
<text x="696" y="458" fill="#bfc0c0" font-size="8" font-family="'Geist Mono', monospace" text-anchor="middle" letter-spacing="0.08em">PAGEVIEW BEACON</text>
|
|
152
|
+
|
|
153
|
+
<!-- =================================================================
|
|
154
|
+
ACTOR BOXES — drawn after arrows/labels.
|
|
155
|
+
Each actor: 144–160 wide × 56 tall. Centers: 128, 352, 584, 800.
|
|
156
|
+
================================================================= -->
|
|
157
|
+
|
|
158
|
+
<!-- Actor 1: Reader (external / soft) -->
|
|
159
|
+
<rect x="56" y="72" width="144" height="56" rx="6" fill="#2d3142"/>
|
|
160
|
+
<rect x="56" y="72" width="144" height="56" rx="6" fill="rgba(191,192,192,0.10)" stroke="#8e98ac" stroke-width="1"/>
|
|
161
|
+
<rect x="64" y="80" width="28" height="12" rx="2" fill="transparent" stroke="rgba(142,140,131,0.40)" stroke-width="0.8"/>
|
|
162
|
+
<text x="78" y="89" fill="#8e98ac" font-size="7" font-family="'Geist Mono', monospace" text-anchor="middle" letter-spacing="0.08em">EXT</text>
|
|
163
|
+
<text x="128" y="104" fill="#f5f5f5" font-size="12" font-weight="600" font-family="'Geist', sans-serif" text-anchor="middle">Reader</text>
|
|
164
|
+
<text x="128" y="119" fill="#bfc0c0" font-size="9" font-family="'Geist Mono', monospace" text-anchor="middle">Browser</text>
|
|
165
|
+
|
|
166
|
+
<!-- Actor 2: Cloudflare (cloud / muted) -->
|
|
167
|
+
<rect x="280" y="72" width="144" height="56" rx="6" fill="#2d3142"/>
|
|
168
|
+
<rect x="280" y="72" width="144" height="56" rx="6" fill="rgba(245,245,245,0.03)" stroke="rgba(245,245,245,0.30)" stroke-width="1"/>
|
|
169
|
+
<rect x="288" y="80" width="32" height="12" rx="2" fill="transparent" stroke="rgba(245,245,245,0.22)" stroke-width="0.8"/>
|
|
170
|
+
<text x="304" y="89" fill="#8e98ac" font-size="7" font-family="'Geist Mono', monospace" text-anchor="middle" letter-spacing="0.08em">EDGE</text>
|
|
171
|
+
<text x="352" y="104" fill="#f5f5f5" font-size="12" font-weight="600" font-family="'Geist', sans-serif" text-anchor="middle">Cloudflare</text>
|
|
172
|
+
<text x="352" y="119" fill="#bfc0c0" font-size="9" font-family="'Geist Mono', monospace" text-anchor="middle">Pages · cache</text>
|
|
173
|
+
|
|
174
|
+
<!-- Actor 3: Astro Origin (focal / coral) -->
|
|
175
|
+
<rect x="504" y="72" width="160" height="56" rx="6" fill="#2d3142"/>
|
|
176
|
+
<rect x="504" y="72" width="160" height="56" rx="6" fill="rgba(240,138,89,0.08)" stroke="#f08a59" stroke-width="1"/>
|
|
177
|
+
<rect x="512" y="80" width="32" height="12" rx="2" fill="transparent" stroke="rgba(240,138,89,0.50)" stroke-width="0.8"/>
|
|
178
|
+
<text x="528" y="89" fill="#f08a59" font-size="7" font-family="'Geist Mono', monospace" text-anchor="middle" letter-spacing="0.08em">ORIG</text>
|
|
179
|
+
<text x="584" y="104" fill="#f5f5f5" font-size="12" font-weight="600" font-family="'Geist', sans-serif" text-anchor="middle">Astro Origin</text>
|
|
180
|
+
<text x="584" y="119" fill="#bfc0c0" font-size="9" font-family="'Geist Mono', monospace" text-anchor="middle">SSR + MDX</text>
|
|
181
|
+
|
|
182
|
+
<!-- Actor 4: Analytics (optional / dashed) -->
|
|
183
|
+
<rect x="728" y="72" width="144" height="56" rx="6" fill="#2d3142"/>
|
|
184
|
+
<rect x="728" y="72" width="144" height="56" rx="6" fill="rgba(245,245,245,0.02)" stroke="rgba(245,245,245,0.22)" stroke-width="1" stroke-dasharray="4,3"/>
|
|
185
|
+
<rect x="736" y="80" width="28" height="12" rx="2" fill="transparent" stroke="rgba(245,245,245,0.22)" stroke-width="0.8"/>
|
|
186
|
+
<text x="750" y="89" fill="#8e98ac" font-size="7" font-family="'Geist Mono', monospace" text-anchor="middle" letter-spacing="0.08em">ASY</text>
|
|
187
|
+
<text x="800" y="104" fill="#f5f5f5" font-size="12" font-weight="600" font-family="'Geist', sans-serif" text-anchor="middle">Analytics</text>
|
|
188
|
+
<text x="800" y="119" fill="#bfc0c0" font-size="9" font-family="'Geist Mono', monospace" text-anchor="middle">Beacon · async</text>
|
|
189
|
+
|
|
190
|
+
<!-- =================================================================
|
|
191
|
+
LEGEND — horizontal strip at the bottom.
|
|
192
|
+
Separator at y=504, eyebrow at y=520, items at y=540–548.
|
|
193
|
+
================================================================= -->
|
|
194
|
+
<line x1="56" y1="504" x2="944" y2="504" stroke="rgba(245,245,245,0.10)" stroke-width="0.8"/>
|
|
195
|
+
<text x="56" y="520" fill="#bfc0c0" font-size="8" font-family="'Geist Mono', monospace" letter-spacing="0.18em">LEGEND</text>
|
|
196
|
+
|
|
197
|
+
<!-- Item 1: Actor swatch (coral focal) -->
|
|
198
|
+
<rect x="56" y="540" width="14" height="10" rx="2" fill="rgba(240,138,89,0.08)" stroke="#f08a59" stroke-width="1"/>
|
|
199
|
+
<text x="76" y="548" fill="#bfc0c0" font-size="8.5" font-family="'Geist', sans-serif">Focal actor</text>
|
|
200
|
+
|
|
201
|
+
<!-- Item 2: Activation bar swatch -->
|
|
202
|
+
<rect x="188" y="536" width="4" height="18" fill="rgba(245,245,245,0.06)" stroke="#bfc0c0" stroke-width="0.8"/>
|
|
203
|
+
<text x="200" y="548" fill="#bfc0c0" font-size="8.5" font-family="'Geist', sans-serif">Activation</text>
|
|
204
|
+
|
|
205
|
+
<!-- Item 3: Request arrow (link-blue) -->
|
|
206
|
+
<line x1="308" y1="546" x2="336" y2="546" stroke="#6a95d8" stroke-width="1.2" marker-end="url(#arrow-link)"/>
|
|
207
|
+
<text x="344" y="548" fill="#bfc0c0" font-size="8.5" font-family="'Geist', sans-serif">HTTP request</text>
|
|
208
|
+
|
|
209
|
+
<!-- Item 4: Return / async (muted dashed) -->
|
|
210
|
+
<line x1="476" y1="546" x2="504" y2="546" stroke="#bfc0c0" stroke-width="1.2" stroke-dasharray="5,4" marker-end="url(#arrow)"/>
|
|
211
|
+
<text x="512" y="548" fill="#bfc0c0" font-size="8.5" font-family="'Geist', sans-serif">Return / async</text>
|
|
212
|
+
|
|
213
|
+
<!-- Item 5: Primary response (coral) -->
|
|
214
|
+
<line x1="652" y1="546" x2="680" y2="546" stroke="#f08a59" stroke-width="1.4" marker-end="url(#arrow-accent)"/>
|
|
215
|
+
<text x="688" y="548" fill="#bfc0c0" font-size="8.5" font-family="'Geist', sans-serif">Primary response</text>
|
|
216
|
+
|
|
217
|
+
</svg>
|
|
218
|
+
</div>
|
|
219
|
+
</body>
|
|
220
|
+
</html>
|
|
@@ -0,0 +1,386 @@
|
|
|
1
|
+
<!DOCTYPE html>
|
|
2
|
+
<html lang="en">
|
|
3
|
+
<head>
|
|
4
|
+
<meta charset="UTF-8">
|
|
5
|
+
<meta name="viewport" content="width=device-width, initial-scale=1.0">
|
|
6
|
+
<title>Article Request · Sequence</title>
|
|
7
|
+
<link href="https://fonts.googleapis.com/css2?family=Instrument+Serif:ital@0;1&family=Geist:wght@400;500;600&family=Geist+Mono:wght@400;500;600&display=swap" rel="stylesheet">
|
|
8
|
+
<style>
|
|
9
|
+
*, *::before, *::after { box-sizing: border-box; margin: 0; padding: 0; }
|
|
10
|
+
|
|
11
|
+
:root {
|
|
12
|
+
--color-paper: #f5f5f5;
|
|
13
|
+
--color-paper-2: #ececec;
|
|
14
|
+
--color-ink: #2d3142;
|
|
15
|
+
--color-muted: #4f5d75;
|
|
16
|
+
--color-soft: #7a8399;
|
|
17
|
+
--color-rule: rgba(45,49,66,0.12);
|
|
18
|
+
--color-rule-solid: rgba(79,93,117,0.25);
|
|
19
|
+
--color-accent: #eb6c36;
|
|
20
|
+
--color-accent-tint: rgba(235,108,54,0.08);
|
|
21
|
+
--color-link: #2e5aa8;
|
|
22
|
+
--font-sans: 'Geist', system-ui, sans-serif;
|
|
23
|
+
--font-serif: 'Instrument Serif', 'Times New Roman', serif;
|
|
24
|
+
--font-mono: 'Geist Mono', ui-monospace, Menlo, monospace;
|
|
25
|
+
}
|
|
26
|
+
|
|
27
|
+
body {
|
|
28
|
+
font-family: var(--font-sans);
|
|
29
|
+
background: var(--color-paper);
|
|
30
|
+
min-height: 100vh;
|
|
31
|
+
padding: 3rem 2rem;
|
|
32
|
+
color: var(--color-ink);
|
|
33
|
+
}
|
|
34
|
+
|
|
35
|
+
.container { max-width: 1200px; margin: 0 auto; }
|
|
36
|
+
|
|
37
|
+
.header { margin-bottom: 2.5rem; }
|
|
38
|
+
|
|
39
|
+
.header-eyebrow {
|
|
40
|
+
font-family: var(--font-mono);
|
|
41
|
+
font-size: 0.66rem;
|
|
42
|
+
font-weight: 500;
|
|
43
|
+
letter-spacing: 0.18em;
|
|
44
|
+
text-transform: uppercase;
|
|
45
|
+
color: var(--color-muted);
|
|
46
|
+
margin-bottom: 0.75rem;
|
|
47
|
+
}
|
|
48
|
+
|
|
49
|
+
h1 {
|
|
50
|
+
font-family: var(--font-serif);
|
|
51
|
+
font-size: clamp(1.75rem, 3vw + 1rem, 2.5rem);
|
|
52
|
+
font-weight: 400;
|
|
53
|
+
letter-spacing: -0.02em;
|
|
54
|
+
line-height: 1.1;
|
|
55
|
+
color: var(--color-ink);
|
|
56
|
+
margin-bottom: 0.5rem;
|
|
57
|
+
}
|
|
58
|
+
|
|
59
|
+
.subtitle {
|
|
60
|
+
font-family: var(--font-sans);
|
|
61
|
+
font-size: 1rem;
|
|
62
|
+
line-height: 1.55;
|
|
63
|
+
color: var(--color-muted);
|
|
64
|
+
max-width: 58ch;
|
|
65
|
+
}
|
|
66
|
+
|
|
67
|
+
.diagram-container {
|
|
68
|
+
background: var(--color-paper-2);
|
|
69
|
+
border-radius: 8px;
|
|
70
|
+
border: 1px solid var(--color-rule);
|
|
71
|
+
padding: 1.5rem;
|
|
72
|
+
overflow-x: auto;
|
|
73
|
+
}
|
|
74
|
+
|
|
75
|
+
svg { width: 100%; min-width: 900px; display: block; }
|
|
76
|
+
|
|
77
|
+
.cards {
|
|
78
|
+
display: grid;
|
|
79
|
+
grid-template-columns: 1.1fr 1fr 0.9fr;
|
|
80
|
+
gap: 1rem;
|
|
81
|
+
margin-top: 1.5rem;
|
|
82
|
+
}
|
|
83
|
+
|
|
84
|
+
@media (max-width: 820px) {
|
|
85
|
+
.cards { grid-template-columns: 1fr; }
|
|
86
|
+
}
|
|
87
|
+
|
|
88
|
+
.card {
|
|
89
|
+
background: #ffffff;
|
|
90
|
+
border-radius: 6px;
|
|
91
|
+
border: 1px solid var(--color-rule);
|
|
92
|
+
padding: 1.25rem;
|
|
93
|
+
}
|
|
94
|
+
|
|
95
|
+
.card .eyebrow {
|
|
96
|
+
font-family: var(--font-mono);
|
|
97
|
+
font-size: 0.5rem;
|
|
98
|
+
letter-spacing: 0.18em;
|
|
99
|
+
text-transform: uppercase;
|
|
100
|
+
color: var(--color-muted);
|
|
101
|
+
margin-bottom: 0.5rem;
|
|
102
|
+
}
|
|
103
|
+
|
|
104
|
+
.card-header {
|
|
105
|
+
display: flex;
|
|
106
|
+
align-items: center;
|
|
107
|
+
gap: 0.6rem;
|
|
108
|
+
margin-bottom: 0.875rem;
|
|
109
|
+
padding-bottom: 0.875rem;
|
|
110
|
+
border-bottom: 1px solid rgba(45,49,66,0.08);
|
|
111
|
+
}
|
|
112
|
+
|
|
113
|
+
.card-dot {
|
|
114
|
+
width: 7px; height: 7px;
|
|
115
|
+
border-radius: 50%;
|
|
116
|
+
flex-shrink: 0;
|
|
117
|
+
}
|
|
118
|
+
.card-dot.ink { background: var(--color-ink); }
|
|
119
|
+
.card-dot.muted { background: var(--color-muted); }
|
|
120
|
+
.card-dot.coral { background: var(--color-accent); }
|
|
121
|
+
.card-dot.link { background: var(--color-link); }
|
|
122
|
+
|
|
123
|
+
.card h3 {
|
|
124
|
+
font-family: var(--font-sans);
|
|
125
|
+
font-size: 0.875rem;
|
|
126
|
+
font-weight: 600;
|
|
127
|
+
color: var(--color-ink);
|
|
128
|
+
letter-spacing: -0.005em;
|
|
129
|
+
}
|
|
130
|
+
|
|
131
|
+
.card p {
|
|
132
|
+
color: var(--color-muted);
|
|
133
|
+
font-size: 0.8125rem;
|
|
134
|
+
line-height: 1.55;
|
|
135
|
+
}
|
|
136
|
+
|
|
137
|
+
.card ul {
|
|
138
|
+
list-style: none;
|
|
139
|
+
color: var(--color-muted);
|
|
140
|
+
font-size: 0.8125rem;
|
|
141
|
+
line-height: 1.55;
|
|
142
|
+
}
|
|
143
|
+
|
|
144
|
+
.card li {
|
|
145
|
+
margin-bottom: 0.3rem;
|
|
146
|
+
padding-left: 0.875rem;
|
|
147
|
+
position: relative;
|
|
148
|
+
}
|
|
149
|
+
|
|
150
|
+
.card li::before {
|
|
151
|
+
content: '—';
|
|
152
|
+
position: absolute;
|
|
153
|
+
left: 0;
|
|
154
|
+
color: rgba(45,49,66,0.25);
|
|
155
|
+
font-size: 0.75rem;
|
|
156
|
+
}
|
|
157
|
+
|
|
158
|
+
.footer {
|
|
159
|
+
margin-top: 2rem;
|
|
160
|
+
padding-top: 1.5rem;
|
|
161
|
+
border-top: 1px solid rgba(45,49,66,0.10);
|
|
162
|
+
font-family: var(--font-mono);
|
|
163
|
+
font-size: 0.72rem;
|
|
164
|
+
letter-spacing: 0.06em;
|
|
165
|
+
color: var(--color-soft);
|
|
166
|
+
display: flex;
|
|
167
|
+
justify-content: space-between;
|
|
168
|
+
align-items: center;
|
|
169
|
+
flex-wrap: wrap;
|
|
170
|
+
gap: 0.5rem;
|
|
171
|
+
}
|
|
172
|
+
</style>
|
|
173
|
+
</head>
|
|
174
|
+
<body>
|
|
175
|
+
<div class="container">
|
|
176
|
+
|
|
177
|
+
<!-- Header -->
|
|
178
|
+
<div class="header">
|
|
179
|
+
<p class="header-eyebrow">Sequence · Diagram Design</p>
|
|
180
|
+
<h1>Article request, cold cache</h1>
|
|
181
|
+
<p class="subtitle">How a content site serves a reader when the requested slug isn't already sitting in Cloudflare's edge cache — origin render, beacon, and back in one round trip.</p>
|
|
182
|
+
</div>
|
|
183
|
+
|
|
184
|
+
<!-- Sequence Diagram -->
|
|
185
|
+
<div class="diagram-container">
|
|
186
|
+
<svg viewBox="0 0 1000 584" xmlns="http://www.w3.org/2000/svg">
|
|
187
|
+
<defs>
|
|
188
|
+
<!-- Dot grid background -->
|
|
189
|
+
<pattern id="dots" width="22" height="22" patternUnits="userSpaceOnUse">
|
|
190
|
+
<circle cx="1" cy="1" r="0.9" fill="rgba(45,49,66,0.10)"/>
|
|
191
|
+
</pattern>
|
|
192
|
+
|
|
193
|
+
<!-- Arrow markers -->
|
|
194
|
+
<marker id="arrow" markerWidth="8" markerHeight="6" refX="7" refY="3" orient="auto">
|
|
195
|
+
<polygon points="0 0, 8 3, 0 6" fill="#4f5d75"/>
|
|
196
|
+
</marker>
|
|
197
|
+
<marker id="arrow-accent" markerWidth="8" markerHeight="6" refX="7" refY="3" orient="auto">
|
|
198
|
+
<polygon points="0 0, 8 3, 0 6" fill="#eb6c36"/>
|
|
199
|
+
</marker>
|
|
200
|
+
<marker id="arrow-link" markerWidth="8" markerHeight="6" refX="7" refY="3" orient="auto">
|
|
201
|
+
<polygon points="0 0, 8 3, 0 6" fill="#2e5aa8"/>
|
|
202
|
+
</marker>
|
|
203
|
+
</defs>
|
|
204
|
+
|
|
205
|
+
<!-- Background: paper + dot grid -->
|
|
206
|
+
<rect width="100%" height="100%" fill="#f5f5f5"/>
|
|
207
|
+
<rect width="100%" height="100%" fill="url(#dots)" opacity="0.55"/>
|
|
208
|
+
|
|
209
|
+
<!-- =================================================================
|
|
210
|
+
LIFELINES — dashed vertical lines from each actor, behind everything.
|
|
211
|
+
Actor lifeline x-coords: 128, 352, 584, 800
|
|
212
|
+
================================================================= -->
|
|
213
|
+
<line x1="128" y1="128" x2="128" y2="488" stroke="rgba(45,49,66,0.22)" stroke-width="1" stroke-dasharray="3,3"/>
|
|
214
|
+
<line x1="352" y1="128" x2="352" y2="488" stroke="rgba(45,49,66,0.22)" stroke-width="1" stroke-dasharray="3,3"/>
|
|
215
|
+
<line x1="584" y1="128" x2="584" y2="488" stroke="rgba(45,49,66,0.22)" stroke-width="1" stroke-dasharray="3,3"/>
|
|
216
|
+
<line x1="800" y1="128" x2="800" y2="488" stroke="rgba(45,49,66,0.22)" stroke-width="1" stroke-dasharray="3,3"/>
|
|
217
|
+
|
|
218
|
+
<!-- =================================================================
|
|
219
|
+
ACTIVATION BARS — w=8 rects on lifelines showing control duration.
|
|
220
|
+
Drawn before message arrows so arrows land on their edges.
|
|
221
|
+
================================================================= -->
|
|
222
|
+
<!-- Cloudflare activation: receives at y=176, responds at y=408 -->
|
|
223
|
+
<rect x="348" y="180" width="8" height="232" fill="rgba(45,49,66,0.06)" stroke="#4f5d75" stroke-width="0.8"/>
|
|
224
|
+
<!-- Astro activation: called at y=232, returns at y=352 -->
|
|
225
|
+
<rect x="580" y="236" width="8" height="120" fill="rgba(45,49,66,0.06)" stroke="#4f5d75" stroke-width="0.8"/>
|
|
226
|
+
|
|
227
|
+
<!-- =================================================================
|
|
228
|
+
MESSAGE ARROWS — time flows top→down.
|
|
229
|
+
Draw before labels so label masks cover the line.
|
|
230
|
+
================================================================= -->
|
|
231
|
+
|
|
232
|
+
<!-- M1: Reader → Cloudflare (HTTPS request · link-blue) -->
|
|
233
|
+
<line x1="128" y1="176" x2="352" y2="176" stroke="#2e5aa8" stroke-width="1.2" marker-end="url(#arrow-link)"/>
|
|
234
|
+
|
|
235
|
+
<!-- M2: Cloudflare → Astro (cache miss · muted) -->
|
|
236
|
+
<line x1="352" y1="232" x2="580" y2="232" stroke="#4f5d75" stroke-width="1.2" marker-end="url(#arrow)"/>
|
|
237
|
+
|
|
238
|
+
<!-- M3: Astro self-message (render MDX · muted U-loop) -->
|
|
239
|
+
<path d="M 588 284 L 624 284 L 624 316 L 588 316" fill="none" stroke="#4f5d75" stroke-width="1.2" marker-end="url(#arrow)"/>
|
|
240
|
+
|
|
241
|
+
<!-- M4: Astro → Cloudflare (return HTML · muted dashed) -->
|
|
242
|
+
<line x1="580" y1="352" x2="356" y2="352" stroke="#4f5d75" stroke-width="1.2" stroke-dasharray="5,4" marker-end="url(#arrow)"/>
|
|
243
|
+
|
|
244
|
+
<!-- M5: Cloudflare → Reader (primary success · coral) -->
|
|
245
|
+
<line x1="348" y1="408" x2="128" y2="408" stroke="#eb6c36" stroke-width="1.4" marker-end="url(#arrow-accent)"/>
|
|
246
|
+
|
|
247
|
+
<!-- M6: Reader → Analytics (async beacon · muted dashed) -->
|
|
248
|
+
<line x1="128" y1="464" x2="800" y2="464" stroke="#4f5d75" stroke-width="1.2" stroke-dasharray="5,4" marker-end="url(#arrow)"/>
|
|
249
|
+
|
|
250
|
+
<!-- =================================================================
|
|
251
|
+
MESSAGE LABELS — each with an opaque paper-colored mask.
|
|
252
|
+
================================================================= -->
|
|
253
|
+
|
|
254
|
+
<!-- M1 label -->
|
|
255
|
+
<rect x="188" y="160" width="104" height="12" rx="2" fill="#f5f5f5"/>
|
|
256
|
+
<text x="240" y="170" fill="#2e5aa8" font-size="8" font-family="'Geist Mono', monospace" text-anchor="middle" letter-spacing="0.08em">GET /ARTICLES/SLUG</text>
|
|
257
|
+
|
|
258
|
+
<!-- M2 label -->
|
|
259
|
+
<rect x="416" y="216" width="100" height="12" rx="2" fill="#f5f5f5"/>
|
|
260
|
+
<text x="466" y="226" fill="#4f5d75" font-size="8" font-family="'Geist Mono', monospace" text-anchor="middle" letter-spacing="0.08em">CACHE MISS · ORIGIN</text>
|
|
261
|
+
|
|
262
|
+
<!-- M3 label (to the right of the self-loop) -->
|
|
263
|
+
<rect x="632" y="292" width="72" height="12" rx="2" fill="#f5f5f5"/>
|
|
264
|
+
<text x="668" y="302" fill="#4f5d75" font-size="8" font-family="'Geist Mono', monospace" text-anchor="middle" letter-spacing="0.08em">RENDER MDX</text>
|
|
265
|
+
|
|
266
|
+
<!-- M4 label -->
|
|
267
|
+
<rect x="420" y="336" width="96" height="12" rx="2" fill="#f5f5f5"/>
|
|
268
|
+
<text x="468" y="346" fill="#4f5d75" font-size="8" font-family="'Geist Mono', monospace" text-anchor="middle" letter-spacing="0.08em">200 · HTML + MAX-AGE</text>
|
|
269
|
+
|
|
270
|
+
<!-- M5 label (coral · primary response) -->
|
|
271
|
+
<rect x="192" y="392" width="96" height="12" rx="2" fill="#f5f5f5"/>
|
|
272
|
+
<text x="240" y="402" fill="#eb6c36" font-size="8" font-family="'Geist Mono', monospace" text-anchor="middle" letter-spacing="0.08em">200 · EDGE-CACHED</text>
|
|
273
|
+
|
|
274
|
+
<!-- M6 label (placed between Astro and Analytics lifelines, a clear gap) -->
|
|
275
|
+
<rect x="648" y="448" width="96" height="12" rx="2" fill="#f5f5f5"/>
|
|
276
|
+
<text x="696" y="458" fill="#4f5d75" font-size="8" font-family="'Geist Mono', monospace" text-anchor="middle" letter-spacing="0.08em">PAGEVIEW BEACON</text>
|
|
277
|
+
|
|
278
|
+
<!-- =================================================================
|
|
279
|
+
ACTOR BOXES — drawn after arrows/labels.
|
|
280
|
+
Each actor: 144–160 wide × 56 tall. Centers: 128, 352, 584, 800.
|
|
281
|
+
================================================================= -->
|
|
282
|
+
|
|
283
|
+
<!-- Actor 1: Reader (external / soft) -->
|
|
284
|
+
<rect x="56" y="72" width="144" height="56" rx="6" fill="#f5f5f5"/>
|
|
285
|
+
<rect x="56" y="72" width="144" height="56" rx="6" fill="rgba(79,93,117,0.10)" stroke="#7a8399" stroke-width="1"/>
|
|
286
|
+
<rect x="64" y="80" width="28" height="12" rx="2" fill="transparent" stroke="rgba(122,131,153,0.40)" stroke-width="0.8"/>
|
|
287
|
+
<text x="78" y="89" fill="#7a8399" font-size="7" font-family="'Geist Mono', monospace" text-anchor="middle" letter-spacing="0.08em">EXT</text>
|
|
288
|
+
<text x="128" y="104" fill="#2d3142" font-size="12" font-weight="600" font-family="'Geist', sans-serif" text-anchor="middle">Reader</text>
|
|
289
|
+
<text x="128" y="119" fill="#4f5d75" font-size="9" font-family="'Geist Mono', monospace" text-anchor="middle">Browser</text>
|
|
290
|
+
|
|
291
|
+
<!-- Actor 2: Cloudflare (cloud / muted) -->
|
|
292
|
+
<rect x="280" y="72" width="144" height="56" rx="6" fill="#f5f5f5"/>
|
|
293
|
+
<rect x="280" y="72" width="144" height="56" rx="6" fill="rgba(45,49,66,0.03)" stroke="rgba(45,49,66,0.30)" stroke-width="1"/>
|
|
294
|
+
<rect x="288" y="80" width="32" height="12" rx="2" fill="transparent" stroke="rgba(45,49,66,0.22)" stroke-width="0.8"/>
|
|
295
|
+
<text x="304" y="89" fill="#7a8399" font-size="7" font-family="'Geist Mono', monospace" text-anchor="middle" letter-spacing="0.08em">EDGE</text>
|
|
296
|
+
<text x="352" y="104" fill="#2d3142" font-size="12" font-weight="600" font-family="'Geist', sans-serif" text-anchor="middle">Cloudflare</text>
|
|
297
|
+
<text x="352" y="119" fill="#4f5d75" font-size="9" font-family="'Geist Mono', monospace" text-anchor="middle">Pages · cache</text>
|
|
298
|
+
|
|
299
|
+
<!-- Actor 3: Astro Origin (focal / coral) -->
|
|
300
|
+
<rect x="504" y="72" width="160" height="56" rx="6" fill="#f5f5f5"/>
|
|
301
|
+
<rect x="504" y="72" width="160" height="56" rx="6" fill="rgba(235,108,54,0.08)" stroke="#eb6c36" stroke-width="1"/>
|
|
302
|
+
<rect x="512" y="80" width="32" height="12" rx="2" fill="transparent" stroke="rgba(235,108,54,0.50)" stroke-width="0.8"/>
|
|
303
|
+
<text x="528" y="89" fill="#eb6c36" font-size="7" font-family="'Geist Mono', monospace" text-anchor="middle" letter-spacing="0.08em">ORIG</text>
|
|
304
|
+
<text x="584" y="104" fill="#2d3142" font-size="12" font-weight="600" font-family="'Geist', sans-serif" text-anchor="middle">Astro Origin</text>
|
|
305
|
+
<text x="584" y="119" fill="#4f5d75" font-size="9" font-family="'Geist Mono', monospace" text-anchor="middle">SSR + MDX</text>
|
|
306
|
+
|
|
307
|
+
<!-- Actor 4: Analytics (optional / dashed) -->
|
|
308
|
+
<rect x="728" y="72" width="144" height="56" rx="6" fill="#f5f5f5"/>
|
|
309
|
+
<rect x="728" y="72" width="144" height="56" rx="6" fill="rgba(45,49,66,0.02)" stroke="rgba(45,49,66,0.22)" stroke-width="1" stroke-dasharray="4,3"/>
|
|
310
|
+
<rect x="736" y="80" width="28" height="12" rx="2" fill="transparent" stroke="rgba(45,49,66,0.22)" stroke-width="0.8"/>
|
|
311
|
+
<text x="750" y="89" fill="#7a8399" font-size="7" font-family="'Geist Mono', monospace" text-anchor="middle" letter-spacing="0.08em">ASY</text>
|
|
312
|
+
<text x="800" y="104" fill="#2d3142" font-size="12" font-weight="600" font-family="'Geist', sans-serif" text-anchor="middle">Analytics</text>
|
|
313
|
+
<text x="800" y="119" fill="#4f5d75" font-size="9" font-family="'Geist Mono', monospace" text-anchor="middle">Beacon · async</text>
|
|
314
|
+
|
|
315
|
+
<!-- =================================================================
|
|
316
|
+
LEGEND — horizontal strip at the bottom.
|
|
317
|
+
Separator at y=504, eyebrow at y=520, items at y=540–548.
|
|
318
|
+
================================================================= -->
|
|
319
|
+
<line x1="56" y1="504" x2="944" y2="504" stroke="rgba(45,49,66,0.10)" stroke-width="0.8"/>
|
|
320
|
+
<text x="56" y="520" fill="#4f5d75" font-size="8" font-family="'Geist Mono', monospace" letter-spacing="0.18em">LEGEND</text>
|
|
321
|
+
|
|
322
|
+
<!-- Item 1: Actor swatch (coral focal) -->
|
|
323
|
+
<rect x="56" y="540" width="14" height="10" rx="2" fill="rgba(235,108,54,0.08)" stroke="#eb6c36" stroke-width="1"/>
|
|
324
|
+
<text x="76" y="548" fill="#4f5d75" font-size="8.5" font-family="'Geist', sans-serif">Focal actor</text>
|
|
325
|
+
|
|
326
|
+
<!-- Item 2: Activation bar swatch -->
|
|
327
|
+
<rect x="188" y="536" width="4" height="18" fill="rgba(45,49,66,0.06)" stroke="#4f5d75" stroke-width="0.8"/>
|
|
328
|
+
<text x="200" y="548" fill="#4f5d75" font-size="8.5" font-family="'Geist', sans-serif">Activation</text>
|
|
329
|
+
|
|
330
|
+
<!-- Item 3: Request arrow (link-blue) -->
|
|
331
|
+
<line x1="308" y1="546" x2="336" y2="546" stroke="#2e5aa8" stroke-width="1.2" marker-end="url(#arrow-link)"/>
|
|
332
|
+
<text x="344" y="548" fill="#4f5d75" font-size="8.5" font-family="'Geist', sans-serif">HTTP request</text>
|
|
333
|
+
|
|
334
|
+
<!-- Item 4: Return / async (muted dashed) -->
|
|
335
|
+
<line x1="476" y1="546" x2="504" y2="546" stroke="#4f5d75" stroke-width="1.2" stroke-dasharray="5,4" marker-end="url(#arrow)"/>
|
|
336
|
+
<text x="512" y="548" fill="#4f5d75" font-size="8.5" font-family="'Geist', sans-serif">Return / async</text>
|
|
337
|
+
|
|
338
|
+
<!-- Item 5: Primary response (coral) -->
|
|
339
|
+
<line x1="652" y1="546" x2="680" y2="546" stroke="#eb6c36" stroke-width="1.4" marker-end="url(#arrow-accent)"/>
|
|
340
|
+
<text x="688" y="548" fill="#4f5d75" font-size="8.5" font-family="'Geist', sans-serif">Primary response</text>
|
|
341
|
+
|
|
342
|
+
</svg>
|
|
343
|
+
</div>
|
|
344
|
+
|
|
345
|
+
<!-- Summary cards -->
|
|
346
|
+
<div class="cards">
|
|
347
|
+
<div class="card">
|
|
348
|
+
<p class="eyebrow">THE HEADLINE</p>
|
|
349
|
+
<div class="card-header">
|
|
350
|
+
<span class="card-dot coral"></span>
|
|
351
|
+
<h3>Edge handles the hot path</h3>
|
|
352
|
+
</div>
|
|
353
|
+
<p>On subsequent reads the whole exchange collapses to M1 → M5. Cloudflare serves the cached HTML without waking the origin. The coral arrow is the only one the reader ever perceives.</p>
|
|
354
|
+
</div>
|
|
355
|
+
|
|
356
|
+
<div class="card">
|
|
357
|
+
<div class="card-header">
|
|
358
|
+
<span class="card-dot ink"></span>
|
|
359
|
+
<h3>Origin render on miss</h3>
|
|
360
|
+
</div>
|
|
361
|
+
<ul>
|
|
362
|
+
<li>Astro SSRs MDX on cold cache</li>
|
|
363
|
+
<li>Returns HTML + cache headers</li>
|
|
364
|
+
<li>Edge stores the result</li>
|
|
365
|
+
<li>Next reader skips the origin trip</li>
|
|
366
|
+
</ul>
|
|
367
|
+
</div>
|
|
368
|
+
|
|
369
|
+
<div class="card">
|
|
370
|
+
<div class="card-header">
|
|
371
|
+
<span class="card-dot muted"></span>
|
|
372
|
+
<h3>Analytics is fire-and-forget</h3>
|
|
373
|
+
</div>
|
|
374
|
+
<p>The pageview beacon is dashed for a reason: the reader never waits on it, and a failed beacon never breaks the page.</p>
|
|
375
|
+
</div>
|
|
376
|
+
</div>
|
|
377
|
+
|
|
378
|
+
<!-- Footer -->
|
|
379
|
+
<div class="footer">
|
|
380
|
+
<span>content site · article request sequence</span>
|
|
381
|
+
<span>example · schematic skill</span>
|
|
382
|
+
</div>
|
|
383
|
+
|
|
384
|
+
</div>
|
|
385
|
+
</body>
|
|
386
|
+
</html>
|