https://github.com/sysgears/spinjs
SpinJS is now Zen! The project has been renamed and moved to Larix Framework.
https://github.com/sysgears/spinjs
Last synced: about 1 year ago
JSON representation
SpinJS is now Zen! The project has been renamed and moved to Larix Framework.
- Host: GitHub
- URL: https://github.com/sysgears/spinjs
- Owner: sysgears
- License: mit
- Created: 2018-08-07T08:16:26.000Z (almost 8 years ago)
- Default Branch: master
- Last Pushed: 2022-12-09T10:12:43.000Z (over 3 years ago)
- Last Synced: 2025-03-28T23:21:58.387Z (about 1 year ago)
- Language: TypeScript
- Homepage: https://github.com/sysgears/larix/tree/master/packages/zen
- Size: 1.19 MB
- Stars: 43
- Watchers: 15
- Forks: 8
- Open Issues: 19
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# SpinJS
**IMPORTANT UPDATE!**
**Our build tool SpinJS has been renamed to _Zen_ and is now maintained in another project**. Please follow to a dedicated
[Zen package] in Larix Framework to make contributions or find out more about our build tool. This repository is now
deprecated.
Happy coding!
___
[](https://gitter.im/sysgears/spinjs?utm_source=badge&utm_medium=badge&utm_campaign=pr-badge&utm_content=badge)
[](https://badge.fury.io/js/spinjs) [](https://twitter.com/sysgears)
## Description
SpinJS is a build tool that can create project builds for production, run them in test mode, and launch your project in
watch mode for development without the need for you to configure the builds. To make this possible, SpinJS analyzes
your project structure and dependencies and decides how to build the project. And unlike many similar build tools,
SpinJS doesn't tie you to a specific framework or lock you out from the generated configurations – you can
customize the project configurations however you need.
To reach the goal, SpinJS reads the `package.json` file as well as the actually installed dependencies in the
`node_modules` directory and then automatically configures the technologies it knows about using custom [plugins].
SpinJS also understands whether you're developing a standalone project, a Lerna monorepo, or a Yarn Workspaces project
to decide how it should be built.
In doing so, SpinJS relieves you from the pains of configuring the project builds for client, server, and native mobile
applications so you can focus on development.
The bottom line is that SpinJS does its best to provide you with an advanced build setup using the minimal information
about the technology stack while still giving you the ability to configure every aspect of how your project gets built.
## Installation
Install SpinJS in development dependencies of your project using Yarn:
```bash
yarn add spinjs --dev
```
Alternately, you can use NPM:
```bash
npm install spinjs --save-dev
```
## Getting Started
To start using SpinJS, you only need to create a basic project and then install the necessary dependencies (including
SpinJS). You can then build and run your project with SpinJS using the command below:
```bash
# Without scripts
yarn spin watch
```
SpinJS will [build your project for development] and launch it in watch mode: upon changes in code, SpinJS will rebuild
the project and reload the build using hot code reload or live code reload.
**NOTE**: If you're using NPM rather than Yarn, you need to add a few scripts to `package.json` to be able to run your
project with SpinJS.
## SpinJS Documentation
You can follow to the documentation to learn more about SpinJS:
* [Concepts]
* [Configuration]
* [How SpinJS Works]
* [SpinJS Scripts]
## Community Support
* [Gitter channel] - ask your questions, find answers, and participate in general discussions!
* [GitHub issues] - submit issues and request new features!
## Commercial Support
The [SysGears] team provides advanced support for commercial partners. A commercial partner will have premium access to
our team to get help with Spin. Contact us using [Skype] or via email **info@sysgears.com**.
## Contributors
Very many thanks to our contributors ([emoji key]):
| [
Victor Vlasenko](https://ua.linkedin.com/in/victorvlasenko)
[💻](https://github.com/sysgears/spin.js/commits?author=vlasenko "Code") [🔧](#tool-vlasenko "Tools") [📖](https://github.com/sysgears/spin.js/commits?author=vlasenko "Documentation") [⚠️](https://github.com/sysgears/spin.js/commits?author=vlasenko "Tests") [💬](#question-vlasenko "Answering Questions") [👀](#review-vlasenko "Reviewed Pull Requests") | [
Ujjwal](https://github.com/mairh)
[💻](https://github.com/sysgears/spin.js/commits?author=mairh "Code") [🔧](#tool-mairh "Tools") [📖](https://github.com/sysgears/spin.js/commits?author=mairh "Documentation") [⚠️](https://github.com/sysgears/spin.js/commits?author=mairh "Tests") [💬](#question-mairh "Answering Questions") [👀](#review-mairh "Reviewed Pull Requests") | [
cdmbase](https://github.com/cdmbase)
[💻](https://github.com/sysgears/spin.js/commits?author=cdmbase "Code") |
| :---: | :---: | :---: |
This project follows the [all-contributors] specification.
We welcome any contributions to the project!
## License
Copyright © 2018 [SysGears INC]. This source code is licensed under the [MIT] license.
[zen package]: https://github.com/sysgears/larix/tree/master/packages/zen
[webpack]: https://webpack.js.org/
[plugins]: https://github.com/sysgears/spinjs/blob/master/docs/concepts.md#plugins
[spinjs scripts]: https://github.com/sysgears/spinjs/blob/master/docs/scripts.md
[build your project for development]: https://github.com/sysgears/spinjs/blob/master/docs/scripts.md#spin-watch
[Concepts]: https://github.com/sysgears/spinjs/blob/master/docs/concepts.md
[Configuration]: https://github.com/sysgears/spinjs/blob/master/docs/configuration.md
[How SpinJS Works]: https://github.com/sysgears/spinjs/blob/master/docs/howSpinWorks.md
[SpinJS Scripts]: https://github.com/sysgears/spinjs/blob/master/docs/scripts.md
[Gitter channel]: https://gitter.im/sysgears/spinjs
[GitHub issues]: https://github.com/sysgears/spinjs/issues
[SysGears]: https://sysgears.com
[skype]: http://hatscripts.com/addskype?sysgears
[emoji key]: https://github.com/kentcdodds/all-contributors#emoji-key
[all-contributors]: https://github.com/kentcdodds/all-contributors
[SysGears INC]: http://sysgears.com
[MIT]: LICENSE