Skip to content

docs: add root README and document backend WebSocket API#26

Open
ShashwatAgrawal20 wants to merge 3 commits into
builder-inc:masterfrom
ShashwatAgrawal20:docs/root-readme
Open

docs: add root README and document backend WebSocket API#26
ShashwatAgrawal20 wants to merge 3 commits into
builder-inc:masterfrom
ShashwatAgrawal20:docs/root-readme

Conversation

@ShashwatAgrawal20

@ShashwatAgrawal20 ShashwatAgrawal20 commented Apr 30, 2026

Copy link
Copy Markdown
Collaborator

closes #24
The API examples within backend/ uses test/test as a demo user.

Support for this user is added in #25

Signed-off-by: Shashwat Agrawal <shashwatagrawal473@gmail.com>
Signed-off-by: Shashwat Agrawal <shashwatagrawal473@gmail.com>
@seivarya

seivarya commented May 3, 2026

Copy link
Copy Markdown
Contributor

you should add a source to some blog for understanding "exchange" too ig?
(just a suggestion of course)

Comment thread README.md Outdated
Comment thread README.md
Comment thread README.md Outdated

This starts a local server. Open the URL shown in your terminal (usually http://localhost:5173).

### Step 4: Start the Simulator

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

nit: we can remove this part. there's not going to be a simulator from what i am aware of

Copy link
Copy Markdown
Collaborator Author

Choose a reason for hiding this comment

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

Yeah, makes sense. I'm not entirely sure if we'll have a simulator part or not, but irrc we might still need it for testing purposes.

Comment thread README.md Outdated
Comment thread README.md Outdated
Comment thread backend/README.md

## API

The server uses **WebSocket over TLS** (`wss://`) on port `7000`. Connect to `wss://localhost:7000`.

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

question: any specific reason for 7000 port? is it convention or just for the love of the game?

Copy link
Copy Markdown
Collaborator Author

Choose a reason for hiding this comment

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

Now that you mention it, I'm not entirely sure where 7000 came from either, probably copied it up from some repos I was referring to. If it was truly for the love of the game, I would've gone with 6969 😜

Replace the draft overview with accurate setup, component roles, and
workflow notes. Demo users match backend AuthManager (shashwat, nero)
instead of the non-existent test/test account. Closes builder-inc#24.
@ShashwatAgrawal20

Copy link
Copy Markdown
Collaborator Author

Pushed a polish pass on this branch:

  • Root README rewritten for accuracy (backend vs simulator roles, port clash note, real workflow).
  • API docs credentials now match AuthManager (shashwat/shashwat, nero/nero) instead of non-existent test/test.

Still closes #24.

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.

Write a beautiful non-AI README detailing the overview of project at root

3 participants