initializing the new learn tab #404

Ethan-Arrowood · 2025-12-05T23:10:05Z

Creates the new Learn tab
Moves the Getting Started section content to Learn
Removes Foundations sections
Updates Getting Started content
- More comprehensive installation guide
- Integrates Foundations content into getting started page
- Adds more examples to first application guide
- Removes unnecessary sections like authentication and deploying from first application guide
- Integrates a new repo that keeps the getting started application content simpler: https://github.com/HarperFast/create-your-first-application (will make public when we merge this PR)
Adds redirects for all old getting-started and foundations content
Simplifies Documentation index pages
- Includes direct link to new Learn section for Getting Started
- Removes reference to Harper Studio from card links (does not remove the studio reference docs)

cap10morgan · 2025-12-12T17:55:18Z

learn/getting-started/install-and-connect-harper.mdx

+
+# Install and Connect Harper
+
+One of Harper's primary goals since day 1 was to be easy to install and get started with. The core Harper application itself is just a Node.js application with some native module dependencies. The simplest and easiest way to get started using Harper is by installing it using npm (or any npm compatible Node.js package manager). In addition to installing Harper directly to your local development environment, the Harper team provides a Docker image ([`harperdb/harperdb`](https://hub.docker.com/r/harperdb/harperdb)), and most recently a platform service called [Harper Fabric](https://fabric.harper.fast).


I think we want to refer people to the newer harpersystems/harper Docker images now. Right, @kriszyp?

I didn't realize we were even publishing there. Should we get rid of that docker org and use harperfast instead? I also think that we are reserving harper for the v5 release. At least we are for the npm package 🤷‍♂️

Yeah probably best to move towards harperfast org there. I grabbed it IIRC.

Should we move towards harperfast/harperdb for new 4.x images and harperfast/harper for eventual 5.x images? @kriszyp (and any others)?

that seems correct to me

learn/getting-started/install-and-connect-harper.mdx

kriszyp

Great stuff, loving this approach!

learn/getting-started/install-and-connect-harper.mdx

learn/getting-started/create-your-first-application.mdx

learn/getting-started/install-and-connect-harper.mdx

kriszyp

Great work. I know there is probably more to polish, but I'm delighted with this.

cb1kenobi

Wow, this is awesome! I love the local/fabric tab stuff. Great job!

Couple nits, but feel free to merge when ready.

learn/getting-started/create-your-first-application.mdx

learn/getting-started/install-and-connect-harper.mdx

learn/index.mdx

release-notes/v4-tucker/4.2.0.md

src/components/learn/general-prerequisites.mdx

docusaurus.config.ts

* first pass * fix workflow maybe * try again * beep boop * - to _ * fix preview-pr script * cancel-in-progress for deploy * fix fetch depth and global install harper

github-actions · 2025-12-19T15:29:40Z

🚀 Preview Deployment

Your preview deployment is ready!

🔗 Preview URL: https://preview.harper-docs.stage.harperfabric.com/pr-404

This preview will update automatically when you push new commits.

Co-authored-by: Chris Barber <chris@harperdb.io>

github-actions · 2025-12-19T16:01:29Z

🚀 Preview Deployment

Your preview deployment is ready!

🔗 Preview URL: https://preview.harper-docs.stage.harperfabric.com/pr-404

This preview will update automatically when you push new commits.

github-actions · 2025-12-19T16:05:29Z

🚀 Preview Deployment

Your preview deployment is ready!

🔗 Preview URL: https://preview.harper-docs.stage.harperfabric.com/pr-404

This preview will update automatically when you push new commits.

github-actions · 2025-12-19T16:16:29Z

🧹 Preview Cleanup

The preview deployment for this PR has been removed.

initializing the new learn tab

f8a24e2

Ethan-Arrowood force-pushed the init-learn branch from 458cdd6 to f8a24e2 Compare December 8, 2025 16:53

Ethan-Arrowood added 4 commits December 8, 2025 17:03

progress

c0a813c

install page draft complete

732e4cc

clean up versioned content and sidebars

8e80bb5

ohhh prettier

ccecd84

cap10morgan reviewed Dec 12, 2025

View reviewed changes

iterate on installation docs more and stub out rest of getting started

0166ad5

kriszyp reviewed Dec 13, 2025

View reviewed changes

learn/getting-started/install-and-connect-harper.mdx Outdated Show resolved Hide resolved

Ethan-Arrowood added 5 commits December 15, 2025 14:38

keep getting started simple

1417431

quick edits before format

4201ea4

fix redirects and format

3a1e828

wtf prettier

12b9353

fix broken links

e377ae4

Ethan-Arrowood marked this pull request as ready for review December 15, 2025 22:57

fix some config

bca1b8c

kriszyp reviewed Dec 16, 2025

View reviewed changes

Ethan-Arrowood added 4 commits December 17, 2025 09:20

fixes

01ef4fa

add deploy to fabric section

7915f5c

switch to PUT

1d8561c

add repo branch references to subsections

53704dc

Ethan-Arrowood requested review from BboyAkers and kriszyp December 17, 2025 18:02

kriszyp approved these changes Dec 17, 2025

View reviewed changes

cb1kenobi approved these changes Dec 19, 2025

View reviewed changes

Preview PRs using Harper Fabric ✨ (#408)

4e12356

* first pass * fix workflow maybe * try again * beep boop * - to _ * fix preview-pr script * cancel-in-progress for deploy * fix fetch depth and global install harper

github-actions bot temporarily deployed to pr-404 December 19, 2025 15:29 Inactive

Apply suggestions from code review

1dc9063

Co-authored-by: Chris Barber <chris@harperdb.io>

github-actions bot temporarily deployed to pr-404 December 19, 2025 16:01 Inactive

Update release-notes/v4-tucker/4.2.0.md

ef064c3

Co-authored-by: Chris Barber <chris@harperdb.io>

github-actions bot temporarily deployed to pr-404 December 19, 2025 16:05 Inactive

Ethan-Arrowood merged commit 01c78b8 into main Dec 19, 2025
5 checks passed

Ethan-Arrowood deleted the init-learn branch December 19, 2025 16:15


		# Install and Connect Harper

		One of Harper's primary goals since day 1 was to be easy to install and get started with. The core Harper application itself is just a Node.js application with some native module dependencies. The simplest and easiest way to get started using Harper is by installing it using npm (or any npm compatible Node.js package manager). In addition to installing Harper directly to your local development environment, the Harper team provides a Docker image ([`harperdb/harperdb`](https://hub.docker.com/r/harperdb/harperdb)), and most recently a platform service called [Harper Fabric](https://fabric.harper.fast).

initializing the new learn tab #404

initializing the new learn tab #404

Uh oh!

Conversation

Ethan-Arrowood commented Dec 5, 2025 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

cap10morgan Dec 12, 2025

Choose a reason for hiding this comment

Uh oh!

Ethan-Arrowood Dec 12, 2025

Choose a reason for hiding this comment

Uh oh!

cap10morgan Dec 16, 2025

Choose a reason for hiding this comment

Uh oh!

Ethan-Arrowood Dec 16, 2025

Choose a reason for hiding this comment

Uh oh!

Uh oh!

kriszyp left a comment

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

kriszyp left a comment

Choose a reason for hiding this comment

Uh oh!

cb1kenobi left a comment

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

github-actions bot commented Dec 19, 2025

🚀 Preview Deployment

Uh oh!

github-actions bot commented Dec 19, 2025

🚀 Preview Deployment

Uh oh!

github-actions bot commented Dec 19, 2025

🚀 Preview Deployment

Uh oh!

Uh oh!

github-actions bot commented Dec 19, 2025

🧹 Preview Cleanup

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

5 participants

Ethan-Arrowood commented Dec 5, 2025 •

edited

Loading