An open API service indexing awesome lists of open source software.

https://github.com/swup/docs

Official swup documentation 📘
https://github.com/swup/docs

animation docs documentation page-transitions router swup

Last synced: about 1 year ago
JSON representation

Official swup documentation 📘

Awesome Lists containing this project

README

          

# Swup Docs

:blue_book: Documentation Website for [swup](https://swup.js.org/)

## Contributing

Something to add? Found a typo? Help your future self and others by updating the docs. Simply edit the appropriate markdown files, the docs will be re-generated automatically ✨

## Install locally

```sh
git clone git@github.com:swup/docs.git
cd ./docs
npm install
```

## Develop & Preview

This site makes use of [Eleventy](https://github.com/11ty/eleventy) for compiling the markdown files to HTML. [WebPack](https://github.com/webpack/webpack) takes care of bundling and transpiling the assets (SCSS, JavaScript).

```sh
npm run watch
```

This will start watch modes for both Eleventy and WebPack.
Your terminal will print the exact `localhost` URL where you can preview your work.

## Build

```sh
npm run build
```

## Deploys

- https://swup.js.org is hosted on GitHub pages via the [deploy workflow](./.github/workflows/deploy.yml)
- https://v3.swup.js.org as well as deploy previews for PRs against the default branch are managed via the Netlify account of @hirasso