Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Uppy Wizard #256

Open
lakesare opened this issue Jul 5, 2024 · 1 comment
Open

Uppy Wizard #256

lakesare opened this issue Jul 5, 2024 · 1 comment

Comments

@lakesare
Copy link
Contributor

lakesare commented Jul 5, 2024

[Slightly edited copypaste from Slack, if you're a transloadit employee please go look at Slack instead, some of the important messages are there]

I think the problem with uppy.io/docs, no matter how we restructure the navigation menu, is that Uppy is a library that doesn't really go well with the list-based documentation. Uppy's structure is tree-like, some options disable some other options.

One way to go about it is to create a choose-your-own-adventure wizard that will be generating Uppy code, similarly to what we do with the Transloadit's Template Wizard. Not only to get people started, I think we can make it so that this is the only thing they'll need for most cases, everything else would be just tinkering with options.


Problems with the current /docs

  1. For beginners it's unclear what's the difference between "sources", "uploaders", "companion" and "golden retriever". They all sound like the same thing. I don't think that developers should know all this uppy lore to get up and running.
  2. When we look at "User Interfaces" => "Elements", nearly all of these elements are ALREADY in Uppy's Dashboard. The only real choice is whether we want to use "Image Editor", but the developer is required to click through all of these to understand her options.
  3. It's not immediately clear that all of the "Sources" listed can only be used with the "Dashboard" UI.

Here is what the uppy wizard could look like approximately:

Choose your FRAMEWORK
    Angular
    React
    Svelte
    Vue

Choose your UI
    Dashboard
    Drag&Drop
        Progress Bar
        Status Bar

Choose your SOURCES [only enabled for Dashboard]
    webcam
    screen capture
    audio
    file input
    oauth
        Transloadit Companion        [1. sign up]
        Express-Integrated Companion [1. set up your own server, 2. for each integration, create an oauth app]
        Standalone Companion         [1. set up your own server, 2. for each integration, create an oauth app]

Choose your UPLOADER
    Tus
        Transloadit                          [1. sign up, 2. sign up on aws]
        Standalone TUS Server (Node, Go)     [1. set up your own server, 2. sign up on aws]
        Integrations (Django, ASP.NET, Node) [1. set up your own server, 2. sign up on aws]
    AWS S3
    XHR

ADDITIONAL
    Compressor
    Golden Retriever
    Image Editor [only enabled for Dashboard]

Re:implementation - escodegen + optionally prettier should be good.

@Murderlon
Copy link
Member

From Tim: poor man's version is reusing the checkboxes and the /examples page and conditionally render code underneath there. Would be done a lot quicker, although it would only be for the CDN, not with framework choice.

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

No branches or pull requests

2 participants