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.
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.
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.
- API Docs showcases the Swagger UI which can help to explore the API directly.
Users app 1m demo:
Deployment 2m demo:
- 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, asking whether tests are passing or looking at jobs logs finding which test failed (thanks to TestForest Dashboard action), Github Actions do this for you.
- 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.
Read the docs or watch our onboarding videos.
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
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.
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.