create-soda-app

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:

• Design Patterns

• Clean Code: A Handbook of Agile Software Craftsmanship

• 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