firebase-tools-ui icon indicating copy to clipboard operation
firebase-tools-ui copied to clipboard

Add QuickStart POC.

Open yuchenshi opened this issue 4 years ago • 3 comments

WIP WIP WIP

Screen Shot 2020-07-17 at 1 40 39 PM

Things that do not quite work:

  • Some markdown extensions
  • Tab switch for languages
  • Using the actual hosts and ports
  • etc.

yuchenshi avatar Jul 17 '20 20:07 yuchenshi

Open question: I wish we can have one single section for Admin SDKs, combining all env vars like so:

export GCLOUD_PROJECT=example
export FIRESTORE_EMULATOR_HOST=localhost:8080
export FIREBASE_DATABASE_EMULATOR_HOST=localhost:9000

Pros: more terse and copy-pasteable. Cons: not consistent with official docs and hard to reuse markdown files. Thoughts? @markarndt

yuchenshi avatar Jul 17 '20 21:07 yuchenshi

As for mechanics, I've built the firesite pages with these files, so great.

As for UX, a dedicated Quickstart Guide page would have to include both Firestore and RTDB instructions (giving some users info they don't need), and without the tab switcher we're getting very long.

What were the issues with certain Markdown extensions?

markarndt avatar Jul 24 '20 23:07 markarndt

As for UX, a dedicated Quickstart Guide page would have to include both Firestore and RTDB instructions (giving some users info they don't need), and without the tab switcher we're getting very long.

I'll work on the tab switcher next.

What were the issues with certain Markdown extensions?

Tab switcher is one of those things. Others include includecode and variables etc. In short, anything with <% is not going to work here.

yuchenshi avatar Jul 28 '20 18:07 yuchenshi