Frequently Asked Questions

  1. What is Bubblin Superbooks?

    A modern ebook reader for the web.

    We're a silent and cozy place to hang out and read interesting classics together, share stories and meet other book-lovers on web. By silent here we mean: no invasive advertising, no loud and convincing reviews from salesmen posing as other readers and only authentic content.

  2. But, but I tend to read books offline…


    All our books are offline-first! They work with or without a live Internet connection.

  3. How does that work… offline-first?

    Offline-first is a form of seamless progressive enhancement that installs a local copy of your book into your browser's cache. Once a book is installed (downloaded) it will continue to work normally on your device even without an Internet connection.

    This process is entirely automatic and is completed the very first time you open a book on your browser; will work even if the browser is refreshed accidentally. See support for Service Workers for more information.

  4. Is this another e-book format?

    Nope. We do away with the idea of files or formats completely.

    It is a travesty that people have to worry about "files" or "formats" when all they need is a nice book to read. With Bubblin, we remove the friction of managing e-book files the very same way Youtube did it for videos.

  5. Ummm… so what do you use?

    Good ol' HTML.

    A Superbook on Bubblin is a single page static app (SPA) with usual markup i.e. HTML, CSS and JavaScript paginated in form of an atomic book.

    Read, love and share books with your friends.

  6. Okay. How is the support?

    A blank book i.e. the Superbook container is supported everywhere.

    All devices, all viewports, all operating systems and all modern browsers.

  7. How is the support on e-readers?

    Not quite. Our intent is to bring books straight on web; i.e. without needing people to buy specialized hardware or to go outside of web to access their ebooks.

    We have tested on some e-readers on market that sport a modern web browser, but understand that web wasn't originally designed to handle longform without pagination.

    More discussion on this post.

  8. What is a Superbook?

    Superbooks represent "Superclass" of books.

    Put simply, a Superbook is a highly-scalable, responsive and battle tested e-book container with "firm layouts" (not fixed!) that holds the content of your book together. Each page of a Superbook is basically a virgin iframe, a sandboxed code playground (think again!) that accepts very limited quantity of HTML, CSS and JavaScript—i.e. the building blocks of web, to render the context. Designing your books this way guarantees quality rendering in a very modular and thoroughly tested manner, thus bringing joy to the experience of book reading online.

    More explaination can be read here.

  9. Does it mean we can add code inside of books?

    Yes, absolutely! That's the magical part of it… 🙂

    You can definitely add programming logic (JavaScript) into your book to make it more interactive or meaningful. Output a visual experiment or an interactive explanation of any sort or a piece of contextual substance that helps the reader understand or grasp a key concept easily.


    View tidal locking between Earth and Moon explained on page number 39 of this demo book on The Solar System. Note, there is plain text on the left side i.e. page #38.

    Use arrow keys or the Space bar to turn the page. Press ⌘ + K to see more shortcuts!

    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.

  10. Please list the main USPs!

    Sure. To begin with, our books work everywhere, on every device, mobile, tablet, desktop and television on the planet. This makes it easy to for people to read and share books online.

    Since we don't use a file system for e-book distribution and rely on HTML (webpages) instead, our books are way more accessible than any other option on market.

    Lastly, we allow JavaScript inside of e-books to make the context modern, enriching and interactive. Such flexibility isn't possible inside a lifeless file that occupies disk somewhere.

    With the ability to add JavaScript inside books you can, say:

    1. Add 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 without worrying about filesize.
    4. Create an album of music videos and lyrics page 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 open up to endless creativity and expression inside of digital books that hasn't been possible until now.

  11. Can I publish on Bubblin?

    Absolutely! It's easy and works just like a blog.

    Refer documentation to get started but here's a quick primer too:

    There are two methods to write and publish a Superbook:

    1. Use the in-browser editor on Bubblin, or
    2. Install Bookiza Abelone— An open source "book reification" framework, i.e. a one-stop publishing engine from your local machine.

    The first option (in-browser editor) is suitable for small one-off publications like outing a comics or a restaurent menu. The second option (Bookiza) is a more professional setup meant for long hauls, or periodicals or marathon novels, literature, textbooks, photobooks and other forms of large texts.

  12. I use Scrivener or MS Word, how does it work for me?

    Not anymore.

    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.

  13. Is there a tutorial?

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

  14. Can I sell my books?

    Yes, you can. But not without proof of ownership or original content that's written by you.

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

    This feature is currently invite-only.

  15. Is this self-publishing?

    Not exactly. It's more like app development with push2deploy.

    Book writing isn't an individual activity. You'd need help from your friends, experts, illustration artists, layout designers, editors and other specialists to polish your work before it is ready for public consumption.

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