# Lucky

Web framework written in Crystal for HTML pages, JSON APIs and single-page frontends, with generators and an ORM.


Source: https://findsoftware.frbit.cloud/lucky/
Last reviewed: 2026-10-26
Listed since: 2026-10-28

## Record

### Links

- home: https://luckyframework.org
- repository: https://github.com/luckyframework/lucky
- docs: https://luckyframework.org/guides/
- bluesky: https://bsky.app/profile/luckyframework.org
- discord: https://discord.com/invite/HeqJUcb

### Identity

- status: active
- maintainer: Paul Smith
- maintainerType: unknown
- parent: unknown
- firstRelease: 2017
- hqCountry: unknown

### Kind

- category: framework
- hosting: binary
- language: crystal
- runtime: binary
- runtimeMin: unknown
- basedOn: unknown

### Content

- contentStore: unknown
- databases: postgres
- adminUi: unknown
- headlessApi: unknown
- templating: unknown
- i18n: unknown

### Rendering and deploy

- runsAs: always-on
- renderingModes: server, spa
- installMethod: Lucky CLI from Homebrew or Scoop, then lucky init

### License

- licenseModel: open-source
- license: MIT

### Releases

- currentMajor: 1
- latestReleaseDate: 2026-04-23

### Adoption

- githubStargazers: 2736
- packagistDownloads: not applicable
- npmWeeklyDownloads: not applicable
- contributors: 88
- pluginCount: unknown
- packagistMonthlyDownloads: unknown
- ecosystemsMonthlyDownloads: unknown
- httpArchiveSites: unknown
- wordpressActiveInstalls: unknown
- dependentRepos: unknown
- dependentPackages: unknown

### Sources

- urls: https://luckyframework.org/ (read 2026-10-26)
- urls: https://api.github.com/repos/luckyframework/lucky (read 2026-10-26)
- urls: https://luckyframework.org/guides/getting-started/installing (read 2026-10-26)
- firstRelease: https://api.github.com/repos/luckyframework/lucky/commits/v0.2.0 (read 2026-10-26)
- maintainer: https://raw.githubusercontent.com/luckyframework/lucky/main/LICENSE (read 2026-10-26)
- category: https://luckyframework.org/ (read 2026-10-26)
- language: https://api.github.com/repos/luckyframework/lucky (read 2026-10-26)
- runtime: https://luckyframework.org/guides/getting-started/installing (read 2026-10-26)
- license: https://api.github.com/repos/luckyframework/lucky (read 2026-10-26)
- licenseModel: https://raw.githubusercontent.com/luckyframework/lucky/main/LICENSE (read 2026-10-26)
- installMethod: https://luckyframework.org/guides/getting-started/installing (read 2026-10-26)
- runsAs: https://luckyframework.org/guides/deploying/ubuntu (read 2026-10-26)
- renderingModes: https://luckyframework.org/ (read 2026-10-26)
- renderingModes: https://luckyframework.org/ (read 2026-10-26)
- databases: https://luckyframework.org/guides/getting-started/installing (read 2026-10-26)
- githubStargazers: https://api.github.com/repos/luckyframework/lucky (read 2026-10-26)
- contributors: https://api.github.com/repos/luckyframework/lucky/contributors?per_page=1 (read 2026-10-26)
- currentMajor: https://api.github.com/repos/luckyframework/lucky/releases (read 2026-10-26)
- latestReleaseDate: https://api.github.com/repos/luckyframework/lucky/releases (read 2026-10-26)

## Notes

Lucky is a web framework written in Crystal for HTML pages, JSON APIs and single-page frontends. Its homepage lists generators, optional built-in authentication and a frontend setup with Bun, Webpack or Vite. Requests are handled by action classes that map each route to its response, and the database layer is built from model and query classes.

A new project starts with the Lucky command-line tool and `lucky init`. The [deployment guides](https://luckyframework.org/guides/deploying/heroku) cover Heroku, Fly.io, Dokku and an Ubuntu server.

## Worth knowing

An app is a long-lived process rather than a set of static files. The Ubuntu guide runs the app under a systemd unit, so the host has to keep that process running, and static hosting does not fit the framework's server-side model.

---

Data licensed CC BY 4.0 (https://creativecommons.org/licenses/by/4.0/). Attributes are recorded, never scored; absent means unknown.
Credit, in full: FindSoftware, CC BY 4.0