The Accord Project Cicero UI Library can be used for implementing React components in your contract editing studio.
This is a short reference guide, for a more full context, please refer to our CONTRIBUTING guide and information for DEVELOPERS.
For using individual components in an app, refer to the individual component's README.
Components ready for use:
Available Plugins:
Components still in development:
ClauseEditor
ParseResult
TemplateLoadingClauseEditor
- Fork project to your repository
- Clone to the local machine with
git clone
cd
into the directory- Run
npm install
- Ensure the
IBM Plex Sans
is imported with<link href="https://fonts.googleapis.com/css?family=IBM+Plex+Sans:300,400,500,500i,700" rel="stylesheet">
is in the *.html file of your main app - Build a production state with
npm run build
- Transpile code for build with
npm run transpile
- Create a global link with
npm link
- In your main app directory, run
npm link @accordproject/cicero-ui
In the project directory, you can run:
Runs the app in the development mode.
Open http://localhost:8080 to view it in the browser.
The page will reload if you make edits.
You will also see any lint errors in the console.
NOTE: These require templates to be passed down through props from an app in which these components should be rendered.
Launches JEST over the repository.
Current snapshot tests require npm test -- -u
to update when all changes are final.
Runs ESLint.
Builds the app for production to the demo
folder.
It correctly bundles React in production mode and optimizes the build for the best performance.
The build is minified and the filenames include the hashes.
Your app is ready to be deployed!
Top level repository (cicero-ui), with sub packages. The entire package is published as an independent npm module:
ClauseEditor
: Functional ReactJS component which displays text of Clause in @accordproject/markdown-editor and parses text using associated template.ContractEditor
: Functional ReactJS component for a rich text contract editor which wraps the @accordproject/markdown-editor editor and assigns the Clause plugin.ErrorLogger
: Functional ReactJS component for displaying model and logic errors associated with contracts and clauses with location information when applicable.Navigation
: Functional ReactJS component for displaying markdown headings and clause nodes associated with contracts.ParseResult
:TemplateLibrary
: Provides a ReactJS component to fetch and display a library of contract and clause templates in the Accord Project Cicero format.TemplateLoadingClauseEditor
:ClausePlugin
: A custom Slate plugin for embedding a clause node within a documentVariablePlugin
: A custom Slate plugin for using editable, highlighted variables within a clauseConditionalPlugin
: A custom Slate plugin for using non-editable but toggle-able, conditional variables within a clauseComputedPlugin
: A custom Slate plugin for using non-editable, highlighted computed fields within a clause
Accord Project is an open source, non-profit, initiative working to transform contract management and contract automation by digitizing contracts. Accord Project operates under the umbrella of the Linux Foundation. The technical charter for the Accord Project can be found here.
- Accord Project
- Accord Project News
- Accord Project Blog
- Accord Project Slack
- Accord Project Technical Documentation
- Accord Project GitHub
- Getting Started with Accord Project
- Concepts and High-level Architecture
- How to use the Cicero Templating System
- How to Author Accord Project Templates
- Ergo Language Guide
Projects | Package name | Version | Description |
---|---|---|---|
Cicero | cicero-core | Templates Core | |
cicero-cli | Cicero CLI | ||
cicero-engine | Node.js VM based implementation of Accord Project Template Specification execution | ||
cicero-server | Wraps the Cicero Engine and exposes it as a RESTful service | ||
cicero-test | Testing support for Cicero based on cucumber | ||
cicero-tools | Cicero Tools | ||
generator-cicero-template | Code generator for a Cicero Template | ||
Concerto | concerto-core | Core Implementation for the Concerto Modeling Language | |
concerto-tools | Tools for the Concerto Modeling Language | ||
concerto-cli | command-line interface for Concerto | ||
Ergo | ergo-cli | Ergo CLI | |
ergo-compiler | Ergo compiler | ||
ergo-test | Ergo test | ||
ergo-engine | Ergo engine | ||
Markdown | markdown-common | A framework for transforming markdown | |
markdown-slate | Transform markdown to/from CommonMark DOM | ||
markdown-cli | CLI for markdown transformations. | ||
markdown-cicero | CiceroDOM: Markdown extensions for contracts, clauses, variables etc. | ||
markdown-html | Transform CiceroDOM to HTML |
Projects | Package name | Version | Description |
---|---|---|---|
Markdown Editor | markdown-editor | WYSIWYG rich text web editor that persists text as markdown. Based on Slate.js | |
Cicero UI | cicero-ui | WYSIWYG contract editor, template library browser, error panel component | |
Concerto UI | concerto-ui | Dynamic web forms generated from Concerto models |
Projects | Cicero ver. | Description |
---|---|---|
Template Studio v1 | 0.13.4 | Web UI for creating, editing and testing Accord Project templates |
Template Studio v2 | 0.13.4 | Web UI for creating, editing and testing Accord Project templates |
VSCode Extension | 0.13.4 | VS Code extension for editing Cicero templates and Ergo logic |
Projects | Description |
---|---|
Models | Accord Project Model Library |
Template Library | Accord Project Template Library |
Project | Repo |
---|---|
Documentation | techdocs |
The Accord Project technology is being developed as open source. All the software packages are being actively maintained on GitHub and we encourage organizations and individuals to contribute requirements, documentation, issues, new templates, and code.
Find out what’s coming on our blog.
Join the Accord Project Technology Working Group Slack channel to get involved!
For code contributions, read our CONTRIBUTING guide and information for DEVELOPERS.
Accord Project source code files are made available under the Apache License, Version 2.0. Accord Project documentation files are made available under the Creative Commons Attribution 4.0 International License (CC-BY-4.0).
Copyright 2018-2019 Clause, Inc. All trademarks are the property of their respective owners. See LF Projects Trademark Policy.