https://github.com/pink-gorilla/webly
reagent/reframe application skelleton
https://github.com/pink-gorilla/webly
bidi cljs reagent ring-handlers shadow-cljs websocket
Last synced: about 1 month ago
JSON representation
reagent/reframe application skelleton
- Host: GitHub
- URL: https://github.com/pink-gorilla/webly
- Owner: pink-gorilla
- Created: 2020-07-10T08:19:39.000Z (over 5 years ago)
- Default Branch: master
- Last Pushed: 2025-04-05T19:31:19.000Z (7 months ago)
- Last Synced: 2025-08-22T16:27:59.610Z (about 2 months ago)
- Topics: bidi, cljs, reagent, ring-handlers, shadow-cljs, websocket
- Language: Clojure
- Homepage:
- Size: 11.2 MB
- Stars: 7
- Watchers: 1
- Forks: 2
- Open Issues: 3
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
Awesome Lists containing this project
README
# Webly [](https://github.com/pink-gorilla/webly/actions?workflow=CI)[](https://clojars.org/org.pinkgorilla/webly)
**End Users** this project is not for you.
- With webly you can build clj/cljs web apps (server: clj, frontend: reagent/reframe)
- webly uses great tools such as: reagent, reframe, tailwind-css, shadow-cljs
- webly brings a things that can be hard to configure (or repetitive) when you develop a web app such as:
- unit test runner
- routing (via edn config), extensible both in frontend and backend
- keybindings
- loading animation
- notifications and dialogs
- webly is used in [Goldly](https://github.com/pink-gorilla/goldly).
# run the ui demo
Clone this repo and run:
```
cd demo-webly
clj -X:webly:npm-install
either:
clj -X:webly:compile
clj -X:webly:run
or
clj -X:webly:run:watch
```
The demo runs a webserver on port 8080.
A simple demo is on [Webly Github Pages](https://pink-gorilla.github.io/webly/)
# features
## web app
- dynamically generated app html that works with csrf
- ring middleware for api calls
- this means a registry for ring-handlers and reagent-views
## webly build
- this feature is available for apps that use webly
- compiles/watches via shadow-cljs
- does not require shadow-cljs.edn
- bundle-size report at compile time
# webly - how to use:
To start webly you have to pass it two parameter: **profile** and **config**
# Webly Compile Profiles
**Webly profile** can be one of the following strings:
- watch: builds and runs shadow dev server (shadow-cljs watch)
- compile: builds bundle and output bundle stats
- release: builds release bundle (for production) no tenx. no source-maps bundle stats
- jetty: runs app, with bundle compiled via compile or release
- ci: builds bundle for unit tests
- npm-install: just installs npm dependencies (based on deps.cljs)
**Webly config**:
- is a clojure datastructure
- is used in backend (clj) and frontend (cljs)
- can be passed as a string (link to a edn file or resource) - mandatory if webly is used in a leiningen project
- can be passed as a clojure datastructure - for quicker configuration in deps.edn projects.
## npm dependencies
- keep your npm depeendencies *only* in deps.cljs
- do NOT create a package.json file!
- package.json will be auto generated
Add npm dependencies that you want to use into a clojure deps.cljs
```
{:npm-deps
{; font awesome
"@fortawesome/fontawesome-free" "^5.13.0"
```
Sometimes github repo and npm module do not match.
Check this to see what goes on: https://unpkg.com/@ricokahler/oauth2-popup-flow@2.0.0-alpha.1/index.js
## unit tests
- clj `bb test-clj`
- cljs: `bb test-cljs`
## static build
```
cd demo-webly
clj -X:webly:compile or clojure -X:webly:release-adv
clj -X:webly:static
cp node_modules/@icon .gorilla/static/index_files -r
./http-server.sh
```