# luckyframework/lucky

A full-featured Crystal web framework that catches bugs for you, runs incredibly fast, and helps you write code that lasts.

Repository: https://github.com/luckyframework/lucky
Canonical: https://ross.abutalabs.com/products/luckyframework-lucky
Homepage: https://luckyframework.org
Language: Crystal
License: MIT
License Family: permissive
Topics: crystal, web, web-framework, lucky-framework, hacktoberfest
Last push: 2026-08-13T14:19:00+00:00

## Health v2 (maintenance only)
Score: 80/100 (v2, computed 2026-09-03T02:20:16.233290+00:00)
- activity 97, release rhythm 48, longevity 100
- inputs: {"age_days": 3526, "days_push": 20, "days_rel": 132, "gap_med": 267.5, "n_releases_24m": 3}
- flags: none
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 2724, forks 173 (observed 2026-08-28T04:07:15.684344+00:00)

## What it is
Lucky is a full-featured web framework written in Crystal that emphasizes catching bugs at compile time through its type system. It includes batteries like authentication, an ORM, routing, and asset management, while delivering very fast, low-memory performance.

## Use cases
- build a fast JSON API in Crystal
- create a full-stack web application with authentication
- migrate from Rails to a faster compiled framework
- build web apps that catch bugs at compile time
- generate CRUD actions and models quickly
- build a low-memory high-throughput web service

## When to choose
- you want Rails-like productivity with compiled-language performance
- you prefer compile-time error checking over runtime bugs
- you're building APIs or web apps in Crystal
- you want authentication, ORM, and routing included out of the box

## When to avoid
- your team doesn't know Crystal and can't invest in learning it
- you need a huge ecosystem of third-party libraries and gems
- you rely on dynamic metaprogramming-heavy patterns
- you need to hire from a large pool of framework-experienced developers

## Facets
- artifact type: framework
- maturity: active
- function: web-framework, routing, orm, auth, templating, http-server
- domain: web-development, backend, apis
- platform: windows, cross-platform
- tags: crystal, full-stack, compile-time-safety, -api, mvc, linux, macos

## Member repositories
- luckyframework/lucky (main) score 80

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:07:15.684344+00:00.
- Health v2: computed from the inputs above; adoption is never an input.
- Inferred fields (summary, facets, guidance): AI-extracted, prompt v1, taxonomy v1, on 2026-08-30T02:14:55.561591+00:00, confidence not recorded.
  - readme: https://github.com/luckyframework/lucky (fetched 2026-08-28T04:07:15.684344+00:00, sha d7bd0ffbc695)
  - homepage: https://luckyframework.org (fetched 2026-08-29T09:58:00.654876+00:00, sha 2c086cb2b604)
  - site_page: https://luckyframework.org/guides/getting-started/installing (fetched 2026-08-29T09:58:00.658953+00:00, sha bd0c4a93d415)
- Data as of 2026-08-30T08:39:29.467469+00:00.