Welcome to the Elegant Contribution Guide! We’re excited to have you here.
This page provides instructions on how to download, and contribute to the core Elegant Framework code. We aim to ensure that everyone in the community feels empowered to contribute and improve our code.
By contributing to the Elegant Framework project, you’re helping us build a more robust application development experience for all developers. Whether you’ve found a typo or some confusing code, or you’ve realized that a particular feature is missing, your contributions are welcomed and appreciated.
We use a few different tools internally for all of our development needs.
The core Elegant code can be found on the Elegant Framework repository. To contribute, you can edit the files directly on GitHub or clone the repo and edit the files locally.
If you’re new to GitHub, we recommend reading the GitHub Open Source Guide to learn how to fork a repository, create a branch, and submit a pull request.
The core Elegant code project is open to all to download, modify, and extend. To download the project and get started with core development, visit our GitHub repository: Elegant on GitHub.
Once you have downloaded the core Elegant project from GitHub and saved it to a directory, you will be ready to start developing the core project and submitting contributions.
The core Elegant code project is broken up into a few different folders:
.github: The `.github` folder contains templates for public contributions, as well as the GitHub Actions CI test code.
integrations: The integrations folder contains code that tests the core Elegant CLI package code as if a developer is downloading it from npm.
scripts: The scripts folder contains basic shell scripts that help automatically deploy the Elegant code along the pipeline as development progresses.
source: The source folder contains all of the core Elegant code used by the Elegant CLI script to create a new application.
How to Begin Developing
The core Elegant code that is used to power a web application is located under `source/elegant/src/`.
You can run the test suite using the following commands:
Please ensure that the tests are passing when submitting a pull request. If you’re adding new features to Elegant, please include tests.
Please ask first before starting work on any significant new features.
It’s never a fun experience to have your pull request declined after investing a lot of time and effort into a new feature. To avoid this from happening, we request that contributors create a feature request to first discuss any significant new ideas.
The innovators tag on npm is a prerelease tag for the version actively being developed. When we merge pull requests into the main branch, we run
npm run publish:innovators, and it will push the changes to a pre-release version on npm.
Developers and innovative Elegant users who want to preview features ahead of an upcoming release can download the *innovators *prerelease with the following:
npm i elegant-cli --tag innovators