Skip to content
This repository was archived by the owner on Oct 16, 2024. It is now read-only.
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
41 commits
Select commit Hold shift + click to select a range
2a47100
fixed some typos
bennobuilder Dec 30, 2020
1a465db
added simple example
bennobuilder Dec 30, 2020
13162ae
updated example
bennobuilder Dec 30, 2020
94eeb29
fixed typos
bennobuilder Dec 30, 2020
ee42d73
fixed codesandbox link
bennobuilder Dec 30, 2020
b43b9b6
add image banner
bennobuilder Dec 30, 2020
a72e5d0
added space
bennobuilder Dec 30, 2020
8285ed8
x
bennobuilder Dec 30, 2020
dbd699c
removed space
bennobuilder Dec 30, 2020
36b2b85
x
bennobuilder Dec 30, 2020
2fce587
fixed typo
bennobuilder Dec 30, 2020
7c6526d
Update ReadMe.md
bennobuilder Dec 30, 2020
4f55b37
x
bennobuilder Dec 30, 2020
af4b895
changed structure
bennobuilder Dec 31, 2020
a5338d0
fixed typo
bennobuilder Dec 31, 2020
8013b4e
fixed some typos
bennobuilder Dec 31, 2020
e78d3b8
Bump ini from 1.3.5 to 1.3.8 in /examples/multieditor-with-react
dependabot[bot] Dec 31, 2020
0181afa
Bump node-notifier in /examples/multieditor-with-react
dependabot[bot] Dec 31, 2020
ab7e0eb
fixed some typos
bennobuilder Dec 31, 2020
c466bf7
Merge remote-tracking branch 'origin/master' into create-proper-readme
bennobuilder Dec 31, 2020
ffc0f4d
added readme to each package
bennobuilder Dec 31, 2020
37add30
added basic readme titles
bennobuilder Dec 31, 2020
6357cd2
update react integration readme
bennobuilder Dec 31, 2020
d546f6f
updated main readme
bennobuilder Dec 31, 2020
764351f
optimized some readmes
bennobuilder Jan 1, 2021
a364949
fixed build command in test workflow
bennobuilder Jan 1, 2021
5b5e8f0
fixed package.json in multieditor example
bennobuilder Jan 1, 2021
0f7ead8
yarn install in multieditor-with-react example
bennobuilder Jan 1, 2021
1e4448c
Merge remote-tracking branch 'origin/dependabot/npm_and_yarn/examples…
bennobuilder Jan 1, 2021
493a5ca
Merge pull request #49 from agile-ts/dependabot/npm_and_yarn/examples…
bennobuilder Jan 1, 2021
e2dcfc9
Merge remote-tracking branch 'origin/develop' into create-proper-readme
bennobuilder Jan 1, 2021
4840e0d
x
bennobuilder Jan 2, 2021
033776c
optimized readmes
bennobuilder Jan 2, 2021
91d2fad
updated header in core readme
bennobuilder Jan 2, 2021
1304eb3
switched to non svg in headerbackground because of weird font
bennobuilder Jan 2, 2021
0aa7586
optimized example of multimedia readme
bennobuilder Jan 2, 2021
2048127
optimized readme's
bennobuilder Jan 2, 2021
9da92b9
optimized readmes
bennobuilder Jan 2, 2021
66f14b2
updated tags
bennobuilder Jan 2, 2021
ae36cac
Merge pull request #51 from agile-ts/create-proper-readme
bennobuilder Jan 2, 2021
c7ff98c
created changeset
bennobuilder Jan 3, 2021
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
8 changes: 8 additions & 0 deletions .changeset/grumpy-teachers-watch.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,8 @@
---
"@agile-ts/api": patch
"@agile-ts/core": patch
"@agile-ts/multieditor": patch
"@agile-ts/react": patch
---

Updated ReadMe's
2 changes: 1 addition & 1 deletion .github/workflows/test-all-packages.yaml
Original file line number Diff line number Diff line change
Expand Up @@ -30,4 +30,4 @@ jobs:

# Build Packages for Testing
- name: 🔨 Build Packages
run: yarn run build:test
run: yarn run build
Binary file added HeaderBackground.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
File renamed without changes.
121 changes: 121 additions & 0 deletions README.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,121 @@
<img src="./HeaderBackground.png" alt="Banner">

> **Spacy**, **Simple**, **Scalable** State Management Framework

<br />

<a href="https://github.com/agile-ts/agile">
<img src="https://img.shields.io/github/license/agile-ts/agile.svg" alt="GitHub License"></a>
<a href="https://npm.im/@agile-ts/core">
<img src="https://img.shields.io/npm/dm/@agile-ts/core.svg" alt="npm monthly downloads"></a>
<a href="https://npm.im/@agile-ts/core">
<img src="https://img.shields.io/npm/dt/@agile-ts/core.svg" alt="npm total downloads"></a>
<a href="https://npm.im/@agile-ts/core">
<img src="https://img.shields.io/bundlephobia/min/@agile-ts/core.svg" alt="npm minified size"></a>
<a href="https://github.com/agile-ts/agile">
<img src="https://img.shields.io/github/languages/code-size/agile-ts/agile.svg" alt="GitHub Code Size"></a>
<a href="https://github.com/agile-ts/agile">
<img src="https://img.shields.io/github/repo-size/agile-ts/agile.svg" alt="GitHub Repo Size"></a>


## 🚀 Look how easy it is
Below example is based on React
```tsx
// At first we have to create an Instance of Agile
const App = new Agile();

// Now we can create a State which has an initial Value of "Hello Stranger!"
const MY_FIRST_STATE = App.State("Hello Stranger!");

// Our cool React Component
const RandomComponent = () => {
// With the Hook 'useAgile' we bind the State to our 'RandomComponent'
const myFirstState = useAgile(MY_FIRST_STATE); // Returns "Hello Stranger!"
// ^
return ( // |
<div> // | Through the 'set' action the State Value
<p>{myFirstState}</p> // | gets changed to "Hello Friend!"
<button // | and causes a rerender on this Component.
onClick={() => { // | -> myFirstState has the Value "Hello Friend!"
// Lets's update the State Value // |
MY_FIRST_STATE.set("Hello Friend!") // -------------
}}
>
Update State
</button>
</div>
);
}
```
_You can't believe the simplicity?! Convince yourself [here](https://codesandbox.io/s/agilets-first-state-f12cz)._


## ❓ Why AgileTs

#### 🚅 Straightforward
Write minimalistic, boilerplate free code that captures your intent. <br />
**For instance**
- Store State in Local Storage
```ts
MY_STATE.persist("storage-key")
```
- Reactive Collection of States
```ts
const MY_COLLECTION = App.Collection();
MY_COLLECTION.collect({id: 1, name: "Frank"});
MY_COLLECTION.collect({id: 2, name: "Dieter"});
```
- Cool State checks and mutations
```ts
MY_STATE.undo(); // Undo last change
MY_STATE.is({hello: "jeff"}); // Check if State has the Value {hello: "jeff"}
```

#### 🤸‍ Flexible
Agile can be used in nearly every UI-Framework
and surly works with the workflow that suits you best,
since Agile isn't bound to _dispatches_, _reducers_, ..

#### 🎯 Easy to Use
Learn the powerful and simple tools of Agile in a short amount of time.

#### ⛳️ Centralize
Manage your Application Logic outside of any UI-Framework in a central place.
This makes your code more decoupled, portable, and above all, easily testable.

#### 🍃 Lightweight
Agile has an unpacked size of [52.7kB](https://bundlephobia.com/result?p=@agile-ts/core@0.0.6)
and [0 dependencies](https://www.npmjs.com/package/@agile-ts/core).


## ⬇️ Installation
```
npm install @agile-ts/core
```
To use Agile we have to install the _core_ package, it's the brain and handles your States, Collections, ..
<br />
```
npm install @agile-ts/react
```
In addition, we need to install a _fitting integration_ for the Framework we are using.. in my case [React](https://www.npmjs.com/package/@agile-ts/react).


## 📄 Documentation
The Agile Docs are located [here](https://agile-ts.org/docs/)


## 🗂 Packages of Agile
| Name | Latest Version | Description |
| ------------------------------------------------------------------------ | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------- |
| [@agile-ts/core](/packages/core) | [![badge](https://img.shields.io/npm/v/@agile-ts/core.svg?style=flat-square)](https://www.npmjs.com/package/@agile-ts/core) | Brain of Agile |
| [@agile-ts/react](/packages/react) | [![badge](https://img.shields.io/npm/v/@agile-ts/react.svg?style=flat-square)](https://www.npmjs.com/package/@agile-ts/react) | React Integration |
| [@agile-ts/api](/packages/api) | [![badge](https://img.shields.io/npm/v/@agile-ts/api.svg?style=flat-square)](https://www.npmjs.com/package/@agile-ts/api) | Promise based Api |
| [@agile-ts/multieditor](/packages/multieditor) | [![badge](https://img.shields.io/npm/v/@agile-ts/multieditor.svg?style=flat-square)](https://www.npmjs.com/package/@agile-ts/multieditor) | Simple Form Manager |


## 👨‍💻 Contribute
Feel free to contribute


## 🌠 Credits
AgileTs is inspired by [PulseJs](https://github.com/pulse-framework/pulse)
40 changes: 0 additions & 40 deletions ReadMe.md

This file was deleted.

1 change: 1 addition & 0 deletions examples/multieditor-with-react/.env
Original file line number Diff line number Diff line change
@@ -0,0 +1 @@
SKIP_PREFLIGHT_CHECK=true
Loading