Skip to content

docs(get-started): add Builders page - #1984

Merged
bvsakhil merged 7 commits into
masterfrom
docs/builders-resources-page
Sep 23, 2026
Merged

bvsakhil merged 7 commits into
masterfrom
docs/builders-resources-page

Conversation

@bvsakhil

@bvsakhil bvsakhil commented Sep 18, 2026 •

Copy link
Copy Markdown
Collaborator

What changed? Why?

Create the Builders and Creators pages under Get Started → Resources.

  • Add the Builders page with Learn, Build, Accelerate, and Scale sections.
  • Add a separate Creators page for the Creator Grant Program.
  • Place Resources below Get Funding in the navigation.
  • Use clear H3 headings for each resource so they appear in the page outline.
  • Convert calls to action into buttons: Learn More, Apply, and Apply buttons for program links.
  • Use white text for all buttons across both pages.
  • Use a Card for the Circuit Accelerator partner.

Notes to reviewers

  • Builders and Creators are separate pages because they serve different audiences.
  • The page content and layout reflect the latest review feedback.

How has it been tested?

  • npm test (85 tests passed)
  • node scripts/lint-mdx.js --files-from=changed-docs.txt --check-nav (0 errors, 0 warnings)
  • Verified locally with mintlify dev.

Screenshots

N/A — text-only content change.

Generated with Toshi

@cb-heimdall

cb-heimdall commented Sep 18, 2026 •

Copy link
Copy Markdown
Collaborator

✅ Heimdall Review Status

Requirement Status More Info
Reviews ✅ 3/1
Denominator calculation
Show calculation
1 if user is bot 0
1 if user is external 0
2 if repo is sensitive 0
From .codeflow.yml 1
Additional review requirements
Show calculation
Max 0
0
From CODEOWNERS 0
Global minimum 0
Max 1
1
1 if commit is unverified 0
Sum 1

@mintlify

mintlify Bot commented Sep 18, 2026 •

Copy link
Copy Markdown
Contributor

Preview deployment for your docs. Learn more about Mintlify Previews.

Project Status Preview Updated
base 🟢 Ready View Preview Sep 23, 2026, 4:15 AM

💡 Tip: Enable Automations to automatically generate PRs for you.

Comment thread docs/get-started/builders.mdx Outdated

## Learn

- **Tutorials:** [Learn the fundamentals](/get-started/base) that will help you get started with building onchain.

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I feel like this fits better with Build vs Learn. It's not exactly tutorials but documentation and references.

Comment thread docs/get-started/builders.mdx Outdated

[Apply here](https://forms.gle/urqjBJYJjR6Vqqre6) to be included in our next cohort.

- **Creator Grant Program:** We're backing independent creators with up to $4,000 who are already making great content around Base across:

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

This feels out of place since creators and builders aren't the same target groups?

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Maybe this should be a separate page?

Comment thread docs/get-started/builders.mdx Outdated

Base backs builders at every stage. This is your directory for the support to help you ship faster, grow faster, and build onchain.

Find your stage below to see what that support looks like.

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

This is redundant. The description has the same message.

Book your slot here: [Office Hours with the Base team](https://forms.gle/iG1oWfGkuMPAp8HX7).

## Accelerate

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Builder Codes doesn't feel like something that belongs under Accelerate. Building Codes attribution doesn't help them accelerate. I think it belongs in the same category as all the funding support we offer.

Comment thread docs/docs.json Outdated
"get-started/docs-llms"
]
},
{

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Move this below Get Funding section

@cb-heimdall

Copy link
Copy Markdown
Collaborator

Review Error for mindapivessa @ 2026-09-21 17:44:54 UTC
User failed mfa authentication, either user does not exist or public email is not set on your github profile. \ see go/mfa-help

@bvsakhil
bvsakhil force-pushed the docs/builders-resources-page branch from cdb8364 to c815f4a Compare September 21, 2026 18:55
@bvsakhil

Copy link
Copy Markdown
Collaborator Author

@mindapivessa Thanks for the review — all feedback addressed in the latest commit (c815f4a):

  • Removed the redundant "Find your stage below…" intro line (it duplicated the description).
  • Moved Tutorials from Learn to Build.
  • Moved Builder Codes next to the grant programs under Accelerate.
  • Split the Creator Grant Program into its own page (docs/get-started/creators.mdx), since creators and builders are distinct audiences. The Resources section now has two pages: Builders and Creators.
  • Moved the Resources group below Get Funding in the navigation.

🤖 Reply generated with Toshi

Comment thread docs/get-started/builders.mdx Outdated

## Learn

- **Builder Quests:** Want to pick up a problem statement to apply your learnings?

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Instead of bullet points, you can use ### Builder Quests (h3 for titles) for all. This way, it's easier to scan and will also show up on the right side on the page.

@bvsakhil
bvsakhil force-pushed the docs/builders-resources-page branch from c815f4a to 117e838 Compare September 21, 2026 19:05
@bvsakhil

Copy link
Copy Markdown
Collaborator Author

@mindapivessa Done in the latest commit (117e838): all items are now H3 headings (### Builder Quests, ### Tutorials, etc.) instead of bold bullets, so each one is scannable and appears in the page's right-hand outline.

🤖 Reply generated with Toshi

@cb-heimdall
cb-heimdall dismissed mindapivessa’s stale review September 21, 2026 20:34

Approved review 5270657106 from mindapivessa is now dismissed due to new commit. Re-request for approval.

@bvsakhil

Copy link
Copy Markdown
Collaborator Author

@mindapivessa The latest Distribution updates are now pushed in commit f5a73a6. All of your earlier feedback has been addressed, and the latest local checks pass. Could you please re-review the current version and approve the PR if it looks good? The IA gate is waiting for Writer approvals on this latest commit.

🤖 Reply generated with Toshi

@bvsakhil

Copy link
Copy Markdown
Collaborator Author

@mindapivessa The latest Builder page reorganization is now pushed in commit 1833694:

  • Builder Codes moved under Build
  • Builder Grant Program and Accelerator Partners moved under Get Funded
  • Documentation remains above Builder Quests
  • Support now contains Builder Stack and distribution content

The local tests and MDX checks pass. Could you please re-review the current version and approve if it looks good?

🤖 Reply generated with Toshi

@bvsakhil

Copy link
Copy Markdown
Collaborator Author

@mindapivessa The latest Builders updates are pushed in commit 4733614:

  • Builder Codes is under Build.
  • Grant Program and Accelerator Partners are under Get Funded.
  • Documentation is under Build above Quests.
  • The section labels are now Quests, Communities, Roundtables, and Grant Program.
  • The Distribution content and CTA updates are included.

Local tests and MDX checks pass. Please re-review the latest version and approve if it looks good.

🤖 Reply generated with Toshi

@roethke
roethke self-requested a review September 22, 2026 20:50
@bvsakhil
bvsakhil merged commit 0e56322 into master Sep 23, 2026
15 checks passed
@bvsakhil
bvsakhil deleted the docs/builders-resources-page branch September 23, 2026 12:42

This branch was successfully deployed

1 active deployment
staging - docs — ae373dad Deployed Sep 23, 2026 by mintlify[bot]
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

5 participants