Frequently Asked Questions

  1. What is Bubblin?

    Bubblin is an Online Café of Books—meaning, a silent and cozy place to hang-out and read together.

    All our books are offline-first (i.e. downloaded instantly) and super-responsive to use. And guess what, they are also FREE to share with anyone. 🙂

    Help us spread the word!

  2. What's offline-first?

    Offline-first is a form of progressive enhancement that effectively downloads (or caches) the contents of your book locally the moment you open it up on your browser (See support). This process is automatic. After this point your book will be available offline on your device and can be read and refreshed with or without live Internet connection.

    It's like downloading safely without needing to click a download button, ala seamless downloads!

  3. Can I publish on Bubblin?

    Yes, absolutely. It works like a blog!

    Here's a quick intro: there are two ways to publish a Superbook:

    1. Use the in-browser editor (a code playground) on https://bubblin.io, or
    2. Install Bookiza — an open source "book reification" framework for the web.

    The in-browser editor (think Codepen) is good for smaller units like a periodical or a magazine or comics, whereas Bookiza, the open source alternative, is better suited for long hauls or marathon novels, textbooks or other large body of texts.

  4. What e-book format is this?

    None. We do away the notion of formats. Readers don't have to worry about file formats or their ensuing compatibility issues.

    In essence your book is just a plain website, a single page static webapp with usual semantic markup, ala HTML-CSS-JavaScript, packed into an offline-first Superbook container with a first class book-like reading experience.

    Free yourself from the shackles of properietary formats, slow and outdated file viewers and expensive hardware. Relieve yourself from the pain of downloading and managing pesky little (enterprise-y) files forever.

  5. Okay. How is the support?

    A blank book (the superbook container) is supported nearly everywhere. All devices, all viewports, all operating systems and all modern browsers.

  6. What is a Superbook?

    Superbook basically means "Superclass of a book". It is a plain e-book container that can be used to hold together the contents of your book.

    Each page of a Superbook is a virgin iframe, a code playground (think Codepen again!) that accepts a limited amount of HTML, CSS and JavaScript i.e. building blocks of web to render a context. This approach makes for a strictly modular and efficient approach to books.

    Note that even though the page is of finite length, the length of book is technically (and theoretically) infinite. Just like a scroll.

  7. Does this mean I can add code in my books?

    Yes.

    Add code that can potentially output say a dynamic visual explanation or some sort of contextual substance that helps the reader grasp the story or a key concept easily.

    Example:

    View tidal locking between Earth and Moon explained on page # 39 of this demo book on The Solar System. Note the plain text alongside on page #38.

    Use arrow keys or the Space bar to turn the page.

    Trivially speaking, the content could be anything from plain text to shaders. Given that a Superbook can render plain text simply, all novels, textbooks and cookbooks (that exist as files outside of web) can now be easily adapted for online and be made available for readers to consume directly without ever leaving the web.

    Here we list some advantages of Superbooks over other rather traditional (and lifeless) forms of e-books such as the epub, PDF or KDP.

  8. Please list its main USPs?

    To begin with, our books work everywhere, on every device on the planet. This makes it easy to manage multiple editions and publish it to everyone from just one place.

    Secondly, our books allow JavaScript inside of each page. It's just simple HTML, CSS and JavaScript! Now this could be a very powerful feature for your own book.

    For example, you can:

    1. Put a little canvas experiment inside your physics book to explain pendulum motion with animation.
    2. Code up a comics book with animated CSS3 characters instead of using heavy GIFs.
    3. Publish a photobook capturing all your memories at one place.
    4. Create an album of music videos and lyrics side-by-side.

    and so on…

    We believe that adapting books for web can lead us to a single unified resource that is both accessible and open. It can spurn endless creativity and expression inside of digital books that isn't possible in existing form of file-driven ebooks.

  9. I'm a writer, how does this work for me?

    The best place to start writing is our documentation page. We provide some of the best-in-class open source tools and free templates to help you start any kind of book, comics or magazine in a matter of minutes.

  10. Is there a tutorial?

    Here's a tutorial on how to write superbooks by Marvin Danig.

  11. Can I price and sell my book?

    Absolutely!

    Connect Stripe to your Bubblin account and start selling. It's dead-simple!

  12. Is this self-publishing?

    Well, not exactly. It's more like app development with push2deploy.

    Involve your friends, artists, designers, front-end developers, book editors and other specialists in your field to polish your work collaboratively using Git. Once, you're ready push out the changes (editions) in real-time to your readers on the fly!

    Excited? Head over to our tools to learn about how to manage your manuscript (project) efficiently.

  13. What fee / cut (royalty) does Bubblin take?

    Zero, but we recommend 10%.

    Feel free to choose a % from your sales to share with us!

  14. Is there an iOS or Android app?

    Native apps are planned. Our first love is web; also it is the last.