Wiringbits Web Application Template
This is the skeleton used by Wiringbits when creating new web applications in Scala/Scala.js, so far, we have created ~10 projects from this template, back-porting useful details to improve it.
If you require building a Web Application in Scala while you do not have the time to do many technical choices, this template could be a reasonable choice.
Why?
Scala has a common misconception, many people believe that it is hard to get productive with it, at Wiringbits, we have proven the contrary with this template. Engineers with no previous Scala experience tend to start contributing simple bug fixes at their first week (including undergrad interns).
Our template provides all the necessary boilerplate to get started fast when building a traditional web application.
Don't waste your time evaluating every library required to build your web app, pick this template and go from there.
Using Scala.js not only save us considerable time, it also allows us to avoid many common issues, for example, all frontend/backend validations are in sync just because the code is the same.
Demo
We have a live demo so that you can get a taste on what our template provides.
- Web App showcases the web application intended for the general user, explore it and create an account to get an idea on what your users will experience.
- Admin App (username =
demo
, password =wiringbits
) showcases the web application intended for administrators, this exposes a way to manage the application's data in a nice UI, mostly autogenerated by react-admin. - API Docs showcases the Swagger UI which can help to explore the API directly.
Short videos
Users app 1m demo:
Admin app 30s demo:
Deployment 2m demo:
What's included?
- User registration and authentication; Including email verification, profile updates, password recovery, and, captcha for spam prevention.
- Integration with the React ecosystem, most libraries/components will work right away, while we use Material UI, you can switch to your preferred component library.
- PostgreSQL as the data store layer, which is a reasonable choice for most web applications.
- Practical components for testing your server-side code, writing tests for the Data/Api layer is real simple, no excuses accepted.
- Practical frontend utilities, for example, test your frontend forms easily, consistent UI when performing asynchronous actions (fetching/submitting data), etc.
- Typed data inputs, don't bother running simple validations to form data at the backend, accepted requests are already validated.
- Reasonable Continuous-Integration workflows, don't waste time reviewing code format or asking whether tests are passing, Github Actions do this for you.
- Admin usually have super-powers, which is why you can export most of your Postgres database to an autogenerated UI (https://marmelab.com/react-admin/), just define which tables/columns must be exported.
- A simple to follow architecture, including short-guides for doing common tasks.
- Deployment scripts to cloud instances, we believe in simplicity and most projects are fine with simple managed servers instead of containers/K8s/etc.
Get started
Read the docs or watch our onboarding videos.
Presentations
There have been some presentations involing this project:
- Jan 2023; ScaLatin; Creando aplicaciones web con Scala/Scala.js; slides
- Oct 2022; ScalaCon; A Practical Skeleton for Your Next Scala Scala js Web Application
Scala.js bundle size
These are code-size measurements from the deployed version at 5/Feb/2023, overall, Scala.js core is minimal, gzipped versions are usually less than 1Mb.
Web app
Admin app
Hire us
The open source work we do is funded by our Scala/Scala.js consulting and development services, schedule a call to hire us for your project.