{"id":20923885,"url":"https://github.com/logofx/aurelia-mvvm-plugin","last_synced_at":"2026-03-05T16:39:37.395Z","repository":{"id":27292251,"uuid":"113242106","full_name":"LogoFX/aurelia-mvvm-plugin","owner":"LogoFX","description":"The set of helpfull infrastructures to build MVVM apps with Aurelia framework.","archived":false,"fork":false,"pushed_at":"2024-04-30T11:41:08.000Z","size":5681,"stargazers_count":1,"open_issues_count":26,"forks_count":0,"subscribers_count":3,"default_branch":"master","last_synced_at":"2025-02-20T01:53:05.511Z","etag":null,"topics":["aurelia","aurelia-mvvm","aurelia-plugins","mvvm"],"latest_commit_sha":null,"homepage":null,"language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/LogoFX.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2017-12-05T22:57:45.000Z","updated_at":"2024-04-30T11:41:12.000Z","dependencies_parsed_at":"2024-05-05T23:15:11.780Z","dependency_job_id":null,"html_url":"https://github.com/LogoFX/aurelia-mvvm-plugin","commit_stats":{"total_commits":86,"total_committers":3,"mean_commits":"28.666666666666668","dds":0.2441860465116279,"last_synced_commit":"586111953e684774007b817b981166909952dbd9"},"previous_names":[],"tags_count":4,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/LogoFX%2Faurelia-mvvm-plugin","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/LogoFX%2Faurelia-mvvm-plugin/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/LogoFX%2Faurelia-mvvm-plugin/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/LogoFX%2Faurelia-mvvm-plugin/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/LogoFX","download_url":"https://codeload.github.com/LogoFX/aurelia-mvvm-plugin/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":243318747,"owners_count":20272139,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["aurelia","aurelia-mvvm","aurelia-plugins","mvvm"],"created_at":"2024-11-18T20:18:19.910Z","updated_at":"2026-03-05T16:39:37.345Z","avatar_url":"https://github.com/LogoFX.png","language":"TypeScript","readme":"# `@logofx/aurelia-mvvm-plugin`\n\nThis library contains a plugin that provides foundational MVVM types.\n\nYou can find an online demo and the documentation here, [https://aurelia-mvvm-plugin.github.io](https://aurelia-mvvm-plugin.github.io).\n\n![GitHub](https://img.shields.io/github/license/LogoFX/aurelia-mvvm-plugin)\n![npm](https://img.shields.io/npm/dt/@logofx/aurelia-mvvm-plugin?logo=npm)\n![npm (scoped)](https://img.shields.io/npm/v/@logofx/aurelia-mvvm-plugin)\n![node-current](https://img.shields.io/node/v/@logofx/aurelia-mvvm-plugin)\n\n[![CircleCI](https://circleci.com/gh/LogoFX/aurelia-mvvm-plugin.svg?style=shield)](https://circleci.com/gh/LogoFX/aurelia-mvvm-plugin)\n![GitHub search hit counter](https://img.shields.io/github/search/logofx/aurelia-mvvm-plugin/aurelia)\n\n## What it does\n\nThe Aurelia framework provides two well-known approaches to create robust WEB applications, which are the component-oriented approach and the approach based on MVVM design pattern. Anyway, the Aurelia lacks implementation of some infrastructures for clean implementation of the MVVM pattern.\n\nIn order to facilitate Aurelia as MVVM framework, the plugin provides base types for implementation of application Models and View-Models. In addition the plugin contains implementation of the Window Manager, as a view-model service allowing to open modal (HTML) dialogs from a view-model in clean VM-First manner.\n\n## Consume Plugin\n\nInstall the plugin:\n\n```shell\nnpm i @logofx/aurelia-mvvm-plugin\n```\n\nThen load the plugin in app's `main.ts` like this.\n\n```js\naurelia.use.plugin('@logofx/aurelia-mvvm-plugin');\n// for webpack user, use PLATFORM.moduleName wrapper\naurelia.use.plugin(PLATFORM.moduleName('@logofx/aurelia-mvvm-plugin'));\n```\n\n## Manage dependencies\n\n![npm peer dependency version](https://img.shields.io/npm/dependency-version/@logofx/aurelia-mvvm-plugin/peer/aurelia-dialog)\n![npm peer dependency version](https://img.shields.io/npm/dependency-version/@logofx/aurelia-mvvm-plugin/peer/aurelia-validation)\n\nIf your application hasn't depended on those packages, please add them manually as your dependencies.\n\n## How to use the code\n\nThis Aurelia plugin project has a built-in dev app (with CLI built-in bundler and RequireJS) to simplify development.\n\n1. The local `src/` folder, is the source code for the plugin.\n2. The local `dev-app/` folder, is the code for the dev app, just like a normal app bootstrapped by aurelia-cli.\n3. You can use normal `au run` and `au test` in development just like developing an app.\n4. You can use aurelia-testing to test your plugin, just like developing an app.\n5. To ensure compatibility to other apps, always use `PLATFORM.moduleName()` wrapper in files inside `src/`. You don't need to use the wrapper in `dev-app/` folder as CLI built-in bundler supports module name without the wrapper.\n\nNote aurelia-cli doesn't provide a plugin skeleton with Webpack setup (not yet), but this plugin can be consumed by any app using Webpack, or CLI built-in bundler, or jspm.\n\nThe usage of `PLATFORM.moduleName` wrapper is mandatory. It's needed for your plugin to be consumed by any app using webpack, CLI built-in bundler, or jspm.\n\n## Building the Code\n\nRun `au build-plugin`. This will transpile all files from `src/` folder to `dist/native-modules/` and `dist/commonjs/`.\n\nFor example, `src/index.ts` will become `dist/native-modules/index.js` and `dist/commonjs/index.js`.\n\nNote all other files in `dev-app/` folder are for the dev app, they would not appear in the published npm package.\n\n## Run dev app\n\nChange the current folder `cd dev-app`\n\nRun `au run`, then open `http://localhost:8080`\n\nTo open browser automatically, do `au run --open`.\n\nTo change dev server port, do `au run --port 9000`.\n\nTo change dev server host, do `au run --host 127.0.0.1`\n\n**PS:** You could mix all the flags as well, `au run --host 127.0.0.1 --port 7070 --open`\n\n## Unit tests\n\nRun `au test` (or `au jest`).\n\nTo run in watch mode, `au test --watch` or `au jest --watch`.\n\n## Acknowledges\n\nThis project is bootstrapped by [aurelia-cli](https://github.com/aurelia/cli).\n","funding_links":[],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Flogofx%2Faurelia-mvvm-plugin","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Flogofx%2Faurelia-mvvm-plugin","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Flogofx%2Faurelia-mvvm-plugin/lists"}