Help

Frequently asked questions

Common questions, short answers. Missing one? Open an issue on GitHub.

Privacy & safety

  • Where does my data go?

    It's fetched from whichever source you connect to (Simply Plural's API, for now), converted in your browser, and written to a file you download. None of it touches our servers.

    Some source APIs won't accept requests directly from a browser, so we forward those through a small proxy. It doesn't log, store, or inspect anything. It's there to satisfy CORS that are required by SimplyPlural. The source is on GitHub if you want to look.

  • Is my API token saved anywhere?

    No. It lives in your browser tab while you're using the converter, and gets sent as a header to the source API through our proxy. The proxy doesn't log or store it.

    Close the tab and the token is gone. Use a Read Only token from Simply Plural so even in the worst case it can't change anything in your system.

  • Do I need an PluralPort or PluralSpace account?

    Nope! It runs in your browser against whichever source you connect to, using either the tokens or (in the future) the JSON files to convert the standards.

Sources & destinations

  • Why isn't my source/destination available yet?

    PluralPort is new. Simply Plural to OpenPlural shipped first because that's what PluralSpace needed (and to help people get their SimplyPlural data in a standardized format). The rest are listed as "Soon" on the About page.

    If you need a specific pairing, open an issue or send a PR! A new converter is one file plus a registry entry.

  • What is OpenPlural?

    An open standard for plural system data that any app can read or write. Current draft is v0.1. Read the spec for details.

  • Can I import an PluralPort export into PluralSpace?

    It will! PluralSpace is working on adding an OpenPlural importer. Convert your data here, then upload the OpenPlural file from PluralSpace's import settings when it's available.

Contributing

  • How do I add a new converter?

    A converter is one TypeScript file in app/lib/converters/ that exports a run function. Sources and destinations are listed in app/lib/registry.ts.

    A contribution guide is coming to explain more on how everything is setup.

  • Where do I report bugs?

    Open an issue on GitHub. Mention the source, destination, and any warnings you saw.

  • Is this affiliated with the apps it converts from?

    No, PluralPort is built by PluralSpace. It's not affiliated with or endorsed by Simply Plural, Octocon, Tupperbox, or any other app it reads from. Logos and product names belong to their respective owners.