Skip to content
Please note that GitHub no longer supports Internet Explorer.

We recommend upgrading to the latest Microsoft Edge, Google Chrome, or Firefox.

Learn more
Framework for next generation web apps using microfrontends. 🚀
TypeScript CSS JavaScript HTML
Branch: develop
Clone or download
Latest commit 986aaf2 Feb 3, 2020
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
.github Added a link to the Contributing guide describing how to setup the de… Dec 10, 2019
.vscode Added launch config for vs code Feb 20, 2019
docs Consolidated package.json metadata #136 Feb 3, 2020
src Consolidated package.json metadata #136 Feb 3, 2020
test Added more component tests Feb 20, 2019
tools
.editorconfig Initial commit Feb 15, 2019
.gitignore Added initializers Aug 28, 2019
.prettierignore Corrected tests May 24, 2019
CHANGELOG.md Started changelog Feb 3, 2020
CODE_OF_CONDUCT.md Improved documentation and structure Feb 16, 2019
LICENSE Initial commit Feb 15, 2019
README.md Improved documentation Jan 31, 2020
jest.config.js Fixed collection issue in jest Dec 29, 2019
lerna.json v0.10.0 Feb 2, 2020
package.json Updated documentation Jan 20, 2020
prettier.config.js Initial commit Feb 15, 2019
tsconfig.json Exclude d.ts files from dist Nov 26, 2019
tslint.json Initial commit Feb 15, 2019
yarn.lock Merged with 0.9.4 Jan 20, 2020

README.md

Piral Logo

Piral · GitHub License Lerna Build Status GitHub Tag GitHub Issues Gitter Chat CLA Assistant

Easily build a next generation portal application using microfrontends. Piral enables you to create a modular frontend application that is extended at runtime with decoupled modules called pilets leveraging a microfrontend architecture. A pilet can be developed independently and ships with the necessary code, as well as all other relevant assets.

This makes Piral an ideal foundation for a mid-sized to large-scale applications developed by distributed teams.

⚡️ A pilet is capable of dynamically extending other pilets or using such extension slots itself.

⚡️ A pilet is isolated (developed and handled) and will never destroy your application.

⚡️ A pilet can be developed with any technology using a standard IDE.

⚡️ A pilet can be updated and published within seconds.

Getting Started

Piral itself is developed as a monorepo. As such this repository may contain an overwhelming amount of information.

Our recommendation is to start at the documentation available at docs.piral.io. Working through the available tutorials will give you the necessary information in the best possible order.

Questions

While the GitHub issues may be used in case of questions, we would prefer general usage questions to be raised either in our Gitter chat or at StackOverflow.

Be sure to check our FAQ and the official tutorials upfront!

Contributing

The main purpose of this repository is to continue to evolve Piral and its core ecosystem, making it faster, more powerful, and easier to use. Development of Piral happens in the open on GitHub, and we are grateful to the community for contributing bugfixes, ideas, and improvements.

Read below to learn how you can take part in improving Piral.

Repository Structure

  • docs contains the (user) documentation
  • src has the sources for all the developed packages, samples, and pages
  • test contains the test setup and (in the future) system tests
  • tools has some of the internal tooling for building the different components

Each subdirectory contains another README.md with more information regarding the contents of the specific folder.

Code of Conduct

We adopted a Code of Conduct that we expect project participants to adhere to. Please read the full text so that you can understand what actions will and will not be tolerated.

Contributing Guide

Read our contributing guide to learn about our development process, how to propose bugfixes and improvements, and how to build and test your changes to Piral.

Good First Issues

To help you get your feet wet and get you familiar with our contribution process, we have a list of good first issues that contain bugs which have a relatively limited scope. This is a great place to get started.

License

Piral is released using the MIT license. For more information see the license file.

You can’t perform that action at this time.