Alpine
| Project Name | Stars | Downloads | Repos Using This | Packages Using This | Most Recent Commit | Total Releases | Latest Release | Open Issues | License | Language |
|---|---|---|---|---|---|---|---|---|---|---|
| Alpine | 24,884 | | 108 | a day ago | 115 | July 02, 2023 | 19 | mit | HTML | |
| A rugged, minimal framework for composing JavaScript behavior in your markup. | ||||||||||
| React Transition Group | 9,771 |  | 47,715 | 6,163 | 5 months ago | 43 | August 01, 2022 | 218 | other | JavaScript |
| An easy way to perform animations when a React component enters or leaves the DOM | ||||||||||
| Ramjet | 5,441 |  | 23 | 7 | 7 years ago | 9 | February 05, 2016 | 11 | mit | JavaScript |
| Morph DOM elements from one state to another with smooth animations and transitions | ||||||||||
| Jquery.magicmove | 654 | 8 years ago | 2 | JavaScript | ||||||
| Animate DOM transitions. | ||||||||||
| React Tiger Transition | 477 | 1 | 9 months ago | 27 | February 14, 2020 | 40 | mit | JavaScript | ||
| Full page transitions with react-router. | ||||||||||
| Dom Helpers | 391 |  | 61,061 | 688 | 2 months ago | 34 | April 26, 2021 | 27 | mit | TypeScript |
| tiny, extremely modular, DOM helper library for IE9+ | ||||||||||
| Touchpoint Js | 296 | 2 years ago | 3 | mit | JavaScript | |||||
| A vanilla JavaScript library that visually shows taps/clicks for HTML prototypes using CSS3 transitions on desktop and mobile. | ||||||||||
| Jquery Ui Carousel | 196 | 7 years ago | 12 | JavaScript | ||||||
| jQuery RS Carousel is a responsive and touch-enabled carousel written on top of jQuery and the jQuery UI Widget Factory providing a full and familiar API in less than 2.6kB minified and gzipped. | ||||||||||
| Glitch.js | 185 | 7 years ago | February 22, 2021 | 4 | JavaScript | |||||
| A glitched effect for DOM elements | ||||||||||
| React.animate | 167 |  | 3 | 4 | 2 years ago | 1 | July 25, 2015 | 1 | mit | JavaScript |
| state animation plugin for react.js | ||||||||||
Alpine.js
Go to the Alpine docs for most things: Alpine Docs
You are welcome to submit updates to the docs by submitting a PR to this repo. Docs are located in the /packages/docs directory.
Stay here for contribution-related information.
Looking for V2 docs? here they are
Contribution Guide:
Quickstart
- clone this repo locally
- run
npm install&npm run build - Include the
/packages/alpinejs/dist/cdn.jsfile from a<script>tag on a webpage and you're good to go!
Brief Tour
You can get everything installed with: npm install in the root directory of this repo after cloning it locally.
This repo is a "mono-repo" using npm workspaces for managing the packages. Each package has its own folder in the /packages directory.
Rather than having to run separate builds for each package, all package bundles are handled with the same command: npm run build
Here's a brief look at each package in this repo:
| Package | Description |
|---|---|
| alpinejs | The main Alpine repo with all of Alpine's core |
| collapse | A plugin for expanding and collapsing elements using smooth animations |
| csp | A repo to provide a "CSP safe" build of Alpine |
| docs | The Alpine documentation |
| focus | A plugin that allows you to manage focus inside an element |
| history | A plugin for binding data to query string parameters using the history API (name is likely to change) |
| intersect | A plugin for triggering JS expressions based on elements intersecting with the viewport |
| mask | A plugin for automatically formatting a text input field as a user types |
| morph | A plugin for morphing HTML (like morphdom) inside the page intelligently |
| persist | A plugin for persisting Alpine state across page loads |
The compiled JS files (as a result of running npm run [build/watch]) to be included as a <script> tag for example are stored in each package's packages/[package]/dist directory.
Each package should at least have: a "cdn" build that is self-initializing and can be included using the src attribute in a <script defer> tag, and a module.[esm/cjs].js file that is used for importing as a JS module (cjs for node, esm for everything else).
The bundling for Alpine V3 is handled exclusively by ESBuild. All of the configuration for these builds is stored in the scripts/build.js file.
Testing
There are 2 different testing tools used in this repo: Cypress (for integration tests), and Jest (for unit tests).
All tests are stored inside the /tests folder under /tests/cypress and /tests/jest.
You can run them both from the command line using: npm run test
If you wish to only run cypress and open it's user interface (recommended during development), you can run: npm run cypress
If you wish to only run Jest tests, you can run npm run jest like normal and target specific tests. You can specify command line config options to forward to the jest command with -- like so: npm run jest -- --watch
