Ionic Core is the fundation of Ionic v4. It's based in Stencil and consist in a set of web components a long of JS and CSS utils.
Before you can build ionic, we assume the following list of software is already installed in your system
- Git
- Node 8 or higher
- Npm 6.0 or higher
In order to contributo to Ionic, you must have a github account so you can push code and create a new Pull Request (PR).
Once you are all setup, following the Github's guide of how to fork a repository: https://guides.github.com/activities/forking/
# Clone your Github repository:
git clone https://github.com/<github username>/ionic.git
# Go to the core directory:
cd ionic/core
# Install npm dependencies
npm install
# Run Ionic dev server
npm start# Move to the core folder
cd core
# Run dev server
npm startYou should be able to navigate to http://localhost:3333 which will look like a file browser.
E2E tests are located inside the src/component folder, in the following way: http://localhost:3333/src/components/{COMPONENT}/test/
Path examples:
- ActionSheet basic test: http://localhost:3333/src/components/action-sheet/test/basic
- Nav basic test: http://localhost:3333/src/components/nav/test/basic
- Button basic test: http://localhost:3333/src/components/button/test/basic
IMPORTANT
Leave the dev server running in the background while you make changes. The dev server listen for changes and automatically recompile Ionic for you.
Components implementations live inside the core/src/components folder.
You can find each ionic component inside their directory.
Before commiting your changes make sure tests are passing:
npm run validate
# Create a git branch
git checkout -b my-improvement
# Add changes
git add .
# Create commit
git commit -m "fix(component): message"Create a PR: https://guides.github.com/activities/forking/
# Clone repo
git clone [email protected]:ionic-team/ionic.git
# Move to ionic/core folder
cd ionic/core
# Install npm dependencies
npm i
# Run dev server
npm start
# Run test suite
npm run validate