Modern JavasScript Development Ecosystem
npm install rocBuild JavaScript projects easily using modern libraries.
Quickly create products powered by libraries like Koa, React and Redux ready for deployment in production with minimal additional setup. Tools like Webpack and Babel power the build process.
Maintained and used in production by teams within Schibsted.
!stability rc
_Currently supports Linux and OS X using Node4+ and npm3_
npm install -g roc@next to test the latest version.All of this is provided by a flexible extension system, and several extensions are available today.
More will be possible in the future and creating your own extension is easy.
$ npm install -g roc@next
$ roc new react-app web-app-react
$ cd react-app && roc dev
!install animationThis will:
* Install Roc
* Create a project that uses React and Redux
* Start the project in development mode
$3
To build and run in production just use:
$ roc build
$ roc start
$3
A very common use-case is to make modifications to your . To get a better understanding of all the possible options in the package use the roc list-settings command or --help for a specific command.Not a boilerplate!
Roc uses templates to initialize new projects.
Templates are very thin skeletons that depend on Roc extensions that manage the typical boilerplate. Meaning only your own code will leave a significant footprint in your project. This allows you to maintain a very clean separation of concerns as your projects evolve.Official Roc extensions are semantically versioned and will include changelogs compiling change summaries, making upgrade paths much simpler across your projects.
Is this not Yeoman?
No.At first sight it might seem that Roc is similar to Yeoman but they do not address the same problem. Yeoman scaffolds a project for you based on a generator that might ask you some questions about how you want to setup your project. However after that has been performed there is no easy way to update the project if a new version of the generator is created. Yeoman will additionally add a lot of code into your project which is basically boilerplate code, that you will seldom touch. And if you manually fix some bug in the generated code you will have to manually do the same work in all other possible projects that are based on the same generator.
Roc will push a lot of the code that you would normally get from a generator away from your project and into versioned packages that can be updated and interacted with through a common interface. This means that you do not get code inside your projects that you will not care about most of the time like configuration files and common boilerplate, making it possible to update it. This leaves you with only the most important code inside your project. Additionally Roc is a composable system making it easy to add additional functionality with minimal effort after the initial project setup.
With that said you could definitely use Yeoman together with Roc if you so wish.
Minimal lock-in
Roc tries to stay out of your way as much as possible and most extensions will not introduce any Roc-specific interfaces. Your project will still use your favourite libraries in the same way as you normally would.Current Official Packages & Plugins
See the repositories under this organisationDocumentation
See the documentation.Motivation
Roc was born out of the need to create modern applications following the correct conventions and using best practices consistently.We quickly realized that keeping boilerplate updated within each project over time was unmanageable. It seems natural to have this _repeated complexity managed by separated semantically versioned packages_.
See this article for a more in-depth overview of the reasoning behind Roc.
Development of Roc was started before these posts where created but they still describe what Roc aims to solve in a good way:
* Challenge: Best JavaScript Setup for Quick Prototyping by @vjeux
* Javascript Fatigue by @ericclemmons
Versioning and stability
Roc follows semantic versioning and is currently pre-release software that will soon be released as stable.It is already used in production by teams within Schibsted as well as other companies and individuals.
Contribute
We are open to, and grateful for, any contributions made by the community.Thanks
Thanks to Jongleberry for letting us use the roc` package name on npm.