Socket
Socket
Sign inDemoInstall

@agile-ts/core

Package Overview
Dependencies
2
Maintainers
1
Versions
37
Alerts
File Explorer

Advanced tools

Install Socket

Detect and block malicious and high-risk dependencies

Install

@agile-ts/core

Spacy, Simple, Scalable State Management Framework


Version published
Maintainers
1
Weekly downloads
52
increased by205.88%

Weekly downloads

Readme

Source

⚠️ No longer actively maintained. In case there will be a higher demand and more known bugs in the future, I will be happy to continue improving this project. But as for now its stable and can be used in any sort of project. In case you face any problem feel free open an issue.

❓ If you've any questions, don't hesitate to start a discussion.

AgileTs

🎇 Global State and Logic Library


GitHub License npm minified size npm total downloads

Status Build Status Build Status Coverage Badge

Tweet Join Discord


How to create a State?
// -- core.js ------------------------------------------

// 1️⃣ Create State with the initial value "Hello Friend!"
const MY_FIRST_STATE = createState("Hello Friend!");


// -- MyComponent.whatever ------------------------------------------

// 2️⃣ Bind initialized State to the desired UI-Component.
// And wolla, the Component is reactive. 
// Everytime the State mutates the Component re-renders.
const myFirstState = useAgile(MY_FIRST_STATE);
console.log(myFirstState); // Returns "Hello Friend!"

Want to learn how to implement AgileTs in your preferred UI-Framework? Check out our Quick Start Guides.

⛳️ Sandbox

Test AgileTs yourself in a codesandbox. It's only one click away. Just select your preferred Framework below.

More examples can be found in the Example section.



Why should I use AgileTs?

AgileTs is an atom based global State and Logic Library implemented in Typescript. It offers a reimagined API that focuses on developer experience and allows you to easily and flexible manage your application States. Besides States, AgileTs offers some other powerful APIs that make your life easier, such as Collections and Computed States. The philosophy behind AgileTs is simple:

🚅 Straightforward

Write minimalistic, boilerplate-free code that captures your intent.

// Create State with the inital value 'frank'
const MY_STATE = createState('frank');

// Update the State value from 'frank' to 'jeff'
MY_STATE.set('jeff');

// Undo the latest State value change
MY_STATE.undo();

// Reset the State value to its initial value
MY_STATE.reset();

// Permanently store the State value in an external Storage
MY_STATE.persist("storage-key"); 

🤸‍ Flexible

  • Works in nearly any UI-Framework (currently supported are React, React-Native and Vue).
  • Surly behaves with the workflow that suits you best. No need for reducers, actions, ..
  • Has 0 external dependencies.

⛳️ Centralize

AgileTs is designed to take all business logic out of the UI-Components and put them in a central place, often called core. The advantage of keeping logic separate to UI-Components, is that your code is more decoupled, portable, scalable, and above all, easily testable.

You can learn more about ways to centralize your application logic with AgileTs in our Style Guides.

🎯 Easy to Use

Learn the powerful tools of AgileTs in a short period of time. An excellent place to start are our Quick Start Guides, or if you don't like to follow tutorials, you can jump straight into the Example section.



Installation

In order to use AgileTs in a UI-Framework, we need to install two packages.

  • The core package contains the State Management Logic of AgileTs and therefore provides powerful classes like the State Class.

    npm install @agile-ts/core
    
  • A fitting Integration for the UI-Framework of your choice, on the other hand, is an interface to the actual UI and provides useful functionalities to bind States to UI-Components for reactivity. I prefer React, so let's go with the React Integration for now.

    npm install @agile-ts/react
    


Documentation

Does AgileTs sound interesting to you? Take a look at our documentation, to learn more about its functionalities and capabilities. If you have any further questions, feel free to join our Community Discord. We will be happy to help you.



Contribute

Get a part of AgileTs and start contributing. We welcome any meaningful contribution. 😀 To find out more about contributing, check out the CONTRIBUTING.md.

Maintainability

♥️ Contributors

Become a contributor



Packages of Agile
NameLatest VersionDescription
@agile-ts/corebadgeState Manager Logic
@agile-ts/reactbadgeReact Integration
@agile-ts/vuebadgeVue Integration
@agile-ts/apibadgePromise based API
@agile-ts/multieditorbadgeSimple Form Manager
@agile-ts/eventbadgeHandy class for emitting UI Events
@agile-ts/loggerbadgeLogging API of AgileTs
@agile-ts/utilsbadgeUtilities of AgileTs
@agile-ts/proxytreebadgeProxy Tree for tracking accessed properties


Credits

AgileTs is inspired by MVVM Libraries like MobX and PulseJs.

🕐 Time spent building this project

wakatime

Keywords

FAQs

Last updated on 04 Sep 2022

Did you know?

Socket for GitHub automatically highlights issues in each pull request and monitors the health of all your open source dependencies. Discover the contents of your packages and block harmful activity before you install or update your dependencies.

Install

Related posts

SocketSocket SOC 2 Logo

Product

  • Package Alerts
  • Integrations
  • Docs
  • Pricing
  • FAQ
  • Roadmap

Stay in touch

Get open source security insights delivered straight into your inbox.


  • Terms
  • Privacy
  • Security

Made with ⚡️ by Socket Inc