egeo-starter is an starter for Angular 2+ applications that includes the Egeo Library of components developed by Stratio. This starter is ready to work with AoT, Karma, Docker, setting its strengths in performance, testing and deployment. This project is developed using angular-cli
It is even possible to connect dinamically the webapp with the server side through Docker configuration. Read about this feature and much more in the wiki of the project.
But this is only a part of the Egeo project. Check the rest of our reports to know more about:
- egeo: the library of components used to build Stratio's applications.
- egeo-web: The official website of Egeo where documentation will be available soon.
- egeo-ui-base: A Sass library that helps us to build our styles, including a rewritten Sass version of flexboxgrid.
- egeo-theme: The egeo components are thematizable. This is the official theme used in the Stratio's applications.
This repo includes the whole needed to begin a new Angular 2+ App, including unit testing platform with Karma, deploy environment with docker and the library of components of Egeo all of them based on angular-cli development.
What you need to run this app:
node
andnpm
- Ensure you're running at least versions of Node
v6.x.x
and NPM3.x.x
You can install egeo-starter from npm:
npm i @stratio/egeo-starter
You can use Npm or Yarn to work with the starter. If you want to use Yarn, it has to be installed first as a global dependency in your local machine.
sudo npm i -g yarn
Once Yarn is installed or Npm is ready, you can install dependencies using:
yarn
or
npm install
To run egeo-starter locally you must use this commands.
yarn start
or
npm run start
There is a command to start the karma server and launch the whole tests written.
yarn test
or
npm run test
It is possible to run an individual test to avoid run the whole suite.
npm run test --component=st-two-list
If you want to build a distributable package you must use the build
command. This will create a dist folder with the distributable code of the package.
yarn build
or
npm run build
If you want to build and run inside a docker container you must use the startup.sh
script. This will create a dist folder with the distributable code of the package and copy inside a docker that run a nginx.
sh ./startup.sh
There are many ways to contribute to the egeo-starter project. Check our contribution section in the Wiki to learn more.
Egeo-starter is distributed under the Apache 2 license. You may obtain a copy of the license here at: