‘Add to home screen’ : Designing & prototyping a native app in HTML

TL;DR: at Paraşüt we built a prototype in HTML & CSS to be able to design, prototype and iteratively test our mobile app. Works great, you should try it.

Especially in world of designing for web, CSS is such a brilliant and relatively simple way of ‘owning up’ to your design: instead of designing for a fixed size canvas and data situation, you have to define constraints and be (at least partly) responsible for how your design behaves in different situations. When designing for native mobile this is not so easy — but this story shows how we tackled it for Paraşüt’s mobile app.

About 1,5 years ago we decided to do a mobile app. Paraşüt has been a SaaS product for SME accounting in Turkey, and was exclusively a web app. From a design point of view, we had a useful and fairly scalable design system, based on Atomic Design combined with a library of utility classes. But we wanted to expand on the idea of doing expenses, invoices and contacts on the go.

We formed a 2-man team; one developer, one designer (me). At this point, our startup was mostly rooted in web technologies, which by its continuous development nature made it easier to build an agile product. For me as a designer it was the same; in the past years of designing for web, I had gotten used to being responsible for the designs I made via CSS.

“So yeah, we tried design deliverables.”

After being set on a clear course for the visual & interaction design of the app, the design (Sketch/Illustrator) files started to look a bit like this (see image).

This drove 2 people crazy: the developer, who always had to ask about one or two dimensions, colours or font-styles I had forgotten to specify, and me, who felt like using a foreign language to explain from the start a system I had figured out in another language.

(I won’t go into the details of the app’s design language too much; that’s a story for another time.)

It had another major drawback that visual design programs have: being unable to design hover states, active states, empty states, animations and transitions. The Zeplin plugin for Sketch takes care of a part of the problems but cannot solve responsive and stateful design. This is the fundamental problem of all classic ‘static canvas’ design tools.

“Designers, don’t stay inside your Sketch cage!”

So at that point, opened an empty index.html file in my browser, and turned on responsive design mode…

This is the button that makes your browser schizophrenic

… and started to implement the design system in simple HTML and CSS. One page, one html file. Icon fonts. Exact and consistent dimensions. The file structure is nothing more than a folder with HTML files, (image) assets and (S)CSS.

Full disclosure: at Parasut, we love designers who code. We have 4 designers, each in a different (product/marketing) team, that are all comfortable writing HTML, (S)CSS and the odd line of jQuery. In practice, this means we deliver HTML mockups to developers, and manage the growth and maintenance of the SCSS design pattern library.

How does it work?

Back to the design for our mobile app. The approach was to create one html page for every mobile view. Let’s take the invoice list for example. The mobile design has a Material Design inspired list view, with a colourful top header, tabs for different list types, and a swipeable list view, with a centred plus button to create a new invoice.

The mockup lives in the browser and is nothing more than a styled list of links

As you can see, the list view design is nothing more than a <ul> with <a> links inside it. We’re using Font Awesome as an icon set, so that’s as easy as adding a <i class=”fa fa-file-text-o”><i> tag. The files sit in a repository on GitHub, which are directly accessible via GitHub Pages as a site, at mobile-ui.parasut.com. Any update I push to that repository will directly be visible to any developer, product manager, or test user visiting that URL.

I’ve set up the file structure so that it contains both the html files for the mockup, as well as the few image assets we have for different resolutions:

The Github repository structure: just html, stylesheets and images

And… as much as I’ld like to dive deeper into how it works, that’s about it! The development workflow comes down to the designer committing the html mockups to the repository and creating a GitHub issue that lists the specs. The developer then opens the mockup in their browser, and keeps referring to that during the implementation. When I asked them about what they think of this workflow, a smile appears on their face and they radiate with joy: no more doubt about how the visual design should be implemented, because it is already defined.


After some initial struggling, we found a great way to work out and iterate our app, both for iOS and Android. I find myself constantly handing the web version of the design over to people, both internally when we are discussing the implementation of a new feature — as well as externally, when testing with users if the design works.

In the end this solution begs the question: wouldn’t it be great if there wasn’t such a disjoint between web and (iOS/Android native)? The web has proven agile and continuously iterative for developers and designers; why can’t designing and building for native mobile be the same? We did once explore the possibility of mapping our SCSS to the Android xml stylesheets, but never took it further.

Do you have any similar experiences with designing for native mobile? I’m curious for your thoughts on this, or other takes on bridging the gap between design and development. I hope this read has been useful and can help you on your way when you’re dealing with the shady uncanny valley of designing for mobile.

— L Daniel Swakman

Daniel is a graphic & web designer working on achieving great visual experiences in digital and analog context, both for startups and freelance.



The people behind Paraşüt share their experiences in building a product, a startup, a culture -to be taken with a pinch of salt and a magnifying glass. 🔎 | Paraşüt’ün arkasındaki insanlar bir ürün, bir start up ve bir kültür yaratma üzerine deneyimlerini paylaşıyor.

Get the Medium app

A button that says 'Download on the App Store', and if clicked it will lead you to the iOS App store
A button that says 'Get it on, Google Play', and if clicked it will lead you to the Google Play store
L Daniel Swakman

Designer! Mostly digital. design⇄code, making things at http://ldaniel.eu . Co-started @muhitapp. Fav side project: http://pheme.app.