Skip to content

Commit 6ad70d3

Browse files
tarasclaude
andauthored
✨ Add the xmd plan section to the homepage (#719)
Place a compact teaching section between "The nesting is the model" and durability: the same ordered instructions shown through both surfaces, `xmd plan` on the left and `<Plan>` on the right, so the row carries the equivalence instead of a sentence. The panels wrap rather than scroll, so each line is its own block and an instruction that wraps takes a 3ch hanging indent — a continuation aligns under the text rather than under the number. Both panels take the same treatment; the two examples differ only in the syntax around them. Also from the same design pass: the footer links Effection, GitHub and Discord; the hero eyebrow and the install section carry a call to star the repository. Claude-Session: https://claude.ai/code/session_012jiQP6cGjp48dneDQDcRK2 Co-authored-by: Claude <noreply@anthropic.com>
1 parent ed5369f commit 6ad70d3

2 files changed

Lines changed: 129 additions & 3 deletions

File tree

‎site/components/Prose.tsx‎

Lines changed: 14 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -65,9 +65,21 @@ export function PageFooter() {
6565
<footer style="border-top:var(--rule) solid var(--line);padding:1.5rem 0;margin-top:1rem;">
6666
<div
6767
class="container"
68-
style={`${MONO}font-size:0.8125rem;color:var(--dim);`}
68+
style={`${MONO}font-size:0.8125rem;color:var(--dim);display:flex;flex-wrap:wrap;align-items:center;justify-content:space-between;gap:0.5rem 1rem;`}
6969
>
70-
Made with ❤️ Effection.
70+
<span>
71+
Made with ❤️{" "}
72+
<a href="https://frontside.com/effection/" rel="noopener">
73+
Effection
74+
</a>.
75+
</span>
76+
<span style="display:flex;flex-wrap:wrap;align-items:center;gap:0.5rem;">
77+
<a href="https://github.com/taras/executable.md" rel="noopener">
78+
GitHub ↗
79+
</a>
80+
<span aria-hidden="true">·</span>
81+
<a href="https://discord.gg/r9F5QrZrP" rel="noopener">Discord ↗</a>
82+
</span>
7183
</div>
7284
</footer>
7385
);

‎site/routes/index.tsx‎

Lines changed: 115 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -39,9 +39,28 @@ const PAIR =
3939
/**
4040
* The release-link hover inverts the base rule: it inherits the eyebrow's
4141
* dim until hover, where it picks up the accent.
42+
*
43+
* The plan panels wrap rather than scroll, so every line is its own block
44+
* instead of a newline in the source — an instruction that wraps then takes a
45+
* 3ch hanging indent and its continuation aligns under the text rather than
46+
* under the number. Both panels take the same treatment: the two examples
47+
* differ only in the syntax around them.
4248
*/
4349
const PAGE_CSS = ".release-link{color:inherit;letter-spacing:inherit;}" +
44-
".release-link:hover{color:var(--green);}";
50+
".release-link:hover{color:var(--green);}" +
51+
"#plan .code-panel pre{white-space:pre-wrap;overflow-wrap:break-word;}" +
52+
"#plan .plan-line{display:block;}" +
53+
"#plan .plan-step{display:block;padding-left:3ch;text-indent:-3ch;}" +
54+
"#plan strong code{font-weight:800;}";
55+
56+
/** The instruction list both plan examples are built from, verbatim. */
57+
const PLAN_STEPS = [
58+
"1. Read package.json and CHANGELOG.md.",
59+
"2. Ask an agent to recommend the next semantic version and explain why.",
60+
"3. Validate the answer.",
61+
"4. Ask me to approve it.",
62+
"5. Write RELEASE.md.",
63+
];
4564

4665
const RELEASE_MD: Tok[][] = [
4766
[bold("# Release")],
@@ -425,6 +444,19 @@ const RUNTIMES: { name: string; body: string; lines: string[][] }[] = [
425444
},
426445
];
427446

447+
/** The plan instructions, one block per line. */
448+
function PlanSteps() {
449+
return (
450+
<>
451+
{PLAN_STEPS.map((step) => (
452+
<span key={step} class="plan-step">
453+
{step}
454+
</span>
455+
))}
456+
</>
457+
);
458+
}
459+
428460
/** A terminal slab whose lines each open with a prompt. */
429461
function Terminal(
430462
{ lines, noWrap }: { lines: string[][]; noWrap?: boolean },
@@ -460,6 +492,10 @@ export default define.page(function Home({ url }) {
460492
rel="noopener"
461493
>
462494
{VERSION}
495+
</a>{" "}
496+
·{" "}
497+
<a class="release-link" href={GITHUB} rel="noopener">
498+
Star on GitHub ↗
463499
</a>
464500
</span>
465501

@@ -844,6 +880,66 @@ export default define.page(function Home({ url }) {
844880
</div>
845881
</section>
846882

883+
{/* Plan */}
884+
<section id="plan" class="section" style="gap:1.5rem;">
885+
<div class="section-head">
886+
<h2>Plans are made to be followed.</h2>
887+
</div>
888+
889+
{/* Same instructions, two surfaces: the row states the equivalence. */}
890+
<div
891+
class="grid"
892+
style="grid-template-columns:repeat(auto-fit,minmax(340px,1fr));align-items:start;"
893+
>
894+
<div style="display:flex;flex-direction:column;gap:0.625rem;min-width:0;">
895+
<span class="eyebrow">CLI</span>
896+
<CodeBlock command>
897+
<span class="plan-line">
898+
<Prompt /> xmd plan "
899+
</span>
900+
<PlanSteps />
901+
<span class="plan-line">"</span>
902+
</CodeBlock>
903+
</div>
904+
905+
<div style="display:flex;flex-direction:column;gap:0.625rem;min-width:0;">
906+
<span class="eyebrow">XMD</span>
907+
<CodeBlock>
908+
<span class="plan-line">
909+
<Source lines={[[key("<Plan>")]]} />
910+
</span>
911+
<PlanSteps />
912+
<span class="plan-line">
913+
<Source lines={[[key("</Plan>")]]} />
914+
</span>
915+
</CodeBlock>
916+
</div>
917+
</div>
918+
919+
<p style={P_MD}>
920+
<strong style={STRONG}>
921+
<Term>xmd plan</Term> is command-line shorthand for{" "}
922+
<Term>{"<Plan>"}</Term>.
923+
</strong>{" "}
924+
Underneath, it expands <Term>{"<Plan>"}</Term>{" "}
925+
with your instructions to produce an XMD program you can review,
926+
change, commit, and run.
927+
</p>
928+
929+
<p style={P_MD}>
930+
<strong style={STRONG}>Planning is part of the language.</strong>
931+
{" "}
932+
<Term>{"<Plan>"}</Term> uses the components exposed by{" "}
933+
<Term>xmd syntax</Term>, so it plans with the same vocabulary
934+
available to you.
935+
</p>
936+
937+
<p style={P_MD}>
938+
Once the workflow says what you mean, run the program instead of
939+
asking an agent to figure it out again.
940+
</p>
941+
</section>
942+
847943
{/* Durability */}
848944
<section id="durability" class="section" style="gap:1.5rem;">
849945
<div style="width:100%;max-width:720px;display:flex;flex-direction:column;gap:1.5rem;">
@@ -954,6 +1050,24 @@ export default define.page(function Home({ url }) {
9541050
>
9551051
Standalone binary · Deno · Node · Bun
9561052
</p>
1053+
1054+
<div
1055+
class="card"
1056+
style="display:flex;flex-wrap:wrap;align-items:center;justify-content:space-between;gap:1rem;"
1057+
>
1058+
<div style="display:flex;flex-direction:column;gap:0.375rem;min-width:0;">
1059+
<span class="eyebrow">Open source · {VERSION}</span>
1060+
<p style={CLAIM}>Star the repository to follow releases.</p>
1061+
</div>
1062+
<a
1063+
class="btn push"
1064+
href={GITHUB}
1065+
rel="noopener"
1066+
style="font-size:0.875rem;font-weight:800;letter-spacing:0.07em;text-transform:uppercase;"
1067+
>
1068+
Star on GitHub ↗
1069+
</a>
1070+
</div>
9571071
</section>
9581072
</div>
9591073

0 commit comments

Comments
 (0)