{"id":"ambergracesoftware/dec","name":"dec","scope":"ambergracesoftware","platform":"roblox","description":"A libary for building Roblox user interfaces","version":"0.1.3","latest":"0.1.3","versions":["0.1.1","0.1.2","0.1.3","0.1.0"],"license":"MIT","licenseRating":"safe","licenseCaveats":[],"licenseVerified":false,"dependencies":{},"integrity":"f5935985fd978f281cfba98bf222f18c388bf66c66f3a51da25ba466fe61170d","likes":0,"downloads":0,"install":"forest install ambergracesoftware/dec","url":"https://forest.dev/p/roblox/ambergracesoftware/dec","files":"https://api.forest.dev/ai/package/roblox/ambergracesoftware/dec/files","readme":"# Dec\n\n<p align=\"center\">\n    <img src=\"logo/Logo256.png\" />\n    <br/>\n    <br/>\n    Dec is a library for building Roblox User Interfaces.\n    <br/>\n    <br/>\n</p>\n\nDec provides tools to prototype animated, responsive UI Components, and\nmanage state across an entire Roblox project. Dec Components can be written\nentirely in Luau, or use premade assets built using Studio's UI editor.\n\n<br/>\n\n| DISCLAIMER: Dec is a work in progress, and does NOT currently have a full release! Please do not use Dec in production-bound code until v1.0.0 has been released. |\n| --- |\n\n<br/>\n\n# Documentation\n\nPlease see the [Documentation Site](https://dec.ambergracesoftware.com) for\ntutorials, a full API reference, and more!\n\n<br/>\n\n# Installation\n\nDec can either be imported into your Roblox project, or installed via Wally.\n\n#### Roblox Studio Installation\n\nTo add Dec to your Roblox Studio project, download the\n[latest `.rbxmx` release from Github](https://github.com/AmberGraceSoftware/Dec/releases/latest),\nthen drag the model file into Roblox Studio. Place the Dec library somewhere in\nReplicatedStorage.\n\n#### Rojo + Wally Installation\n\nTo install Dec using Wally, first install [Rojo](https://rojo.space/docs/v7/)\nand [Wally](https://wally.run/install), then search for the last published Dec\nrelease on the [Wally website](https://wally.run/package/ambergracesoftware/dec),\nor run the following command to get the latest version:\n```sh\n$ wally search ambergracesoftware/dec\n```\nTo add Dec to your project, add an entry under the `[dependencies]` section of\nyour project's `wally.toml` file, replacing `X.Y.Z` with Dec's latest version\nnumber:\n```toml\nDec = \"ambergracesoftware/dec@X.Y.Z\"\n```\n\nFinally, run\n```sh\n$ wally install\n```\nOn the command line to get have the latest install added to your project's\nPackages folder.\n\nIt is also recommended you run the\n[wally-package-types](https://crates.io/crates/wally-package-types) tool after\ninstalling or updating Dec, as well as the\n[Luau LSP](https://github.com/JohnnyMorganz/luau-lsp) in order to utilize Dec\nwith Luau's type safety features.\n\n<br/>\n\n# Contributing\n\nTo contribute to Dec's development, you may fork this repository.\n\nDec uses the following toolchain for library development:\n- [aftman](https://github.com/LPGhatguy/aftman)\n    - Run `aftman install` in the root directory\n    - Run `wally install` to install Dec's dev dependencies (i.e. testez)\n- [Visual Studio Code](https://code.visualstudio.com/)\n- [Luau LSP VS Code Extension](https://marketplace.visualstudio.com/items?itemName=JohnnyMorganz.luau-lsp), which should be configured to include the testez declaration file.\n![](https://i.imgur.com/x9LjJDy.png)\n- [Selene VS Code extension](https://marketplace.visualstudio.com/items?itemName=Kampfkarren.selene-vscode)\n- [Moonwave](https://eryn.io/moonwave/)\n    - Install via `npm i -g moonwave@latest`\n    - Run `moonwave dev` to live test the docs site in your local branch\n\nDec uses unit testing to validate code quality. Because Roblox Studio tests\ncannot currently be fully automated, unit tests must be run manually before\nchanges can be merged into the main branch. To perform this process:\n- Sync the build via `rojo build --output Dec.rbxlx`\n- Open the build in Roblox Studio, and run the command line script located in `game.ServerScriptStorage.TestRunner`\n- Copy the \"proof checksum\" generated in Studio's output and replace the contents `testing_proof_checksum.txt` with this checksum, then commit this directly to the branch.\n- Github will automatically start an action which compares the source code with the proof checksum. If it matches, and the unit tests were all successful, the current branch will be marked as safe to merge.\n","readmeTruncated":false}