create-soda-app v1.0.9
Create Soda App
The easiest way to create a Soda app
- Preface — A brief intro
- Getting Started — How to create an app
- Templates — List of available templates
If you run into any issues or have feedback, please file an issue
TL;DR
yarn global add create-soda-app
create-soda-app my-app
cd my-app
yarn dev
Preface
What is Soda?
Soda is a way to create reliable applications with NodeJS according to SOLID and GRASP principles with top notch developer experience.
Why TypeScript?
TypeScript provides much needed strict static type system allowing us to make development process easier, to reduce required amount of unit tests and to make our app more predictable.
What about performance?
We compile TypeScript to regular JS in production mode and use a regular NodeJS to make sure that app runs as fast as possible.
What else do I need to start creating beautifull reliable apps?
These great books can help a lot if you decided to build a Soda app:
Clean Architecture: A Craftsman's Guide to Software Structure and Design
Code Complete: A Practical Handbook of Software Construction
Getting Started
Installation
Install it once globally:
yarn global add create-soda-app
or
npm install -g create-soda-app
You’ll need to have Node >= 6 on your machine. You can use nvm to easily switch Node versions between different projects.
Creating an App
To create a new app, run:
create-soda-app my-app
cd my-app
It will create a directory called my-app
inside the current folder.
Execute npm run dev
and open http://localhost:8080 to view your running app.
When you're ready for production, run npm run build
then npm run prod
.
You don't need to setup TypeScript.
They come delivered with soda
, so you can just start coding.
After running create-soda-app
, you're good to go!
Templates
This package provides usefull templates to start building a Soda app.
default
Basic template with preconfigured TypeScript build, Docker container and convinient developer enviroment.
other templates
... coming soon
Questions? Feedback? Please let us know