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

https://github.com/stephendolan/lucky_jumpstart

Get up and running quickly with Lucky!
https://github.com/stephendolan/lucky_jumpstart

crystal lucky-framework

Last synced: 11 months ago
JSON representation

Get up and running quickly with Lucky!

Awesome Lists containing this project

README

          

# โ˜˜๏ธ Lucky Jumpstart

This is a template project for web applications using [Lucky](https://luckyframework.org).

[![Lucky App CI](https://github.com/stephendolan/lucky_jumpstart/actions/workflows/lucky.yml/badge.svg)](https://github.com/stephendolan/lucky_jumpstart/actions/workflows/lucky.yml)

### How to use it?

1. Click [this link](https://github.com/stephendolan/lucky_jumpstart/generate)
1. Run `./script/setup`
1. Run `lucky dev`

### Why use a template?

There are quite a few things I find myself adding to every Lucky application out of the box, and this serves as a bit of a better starting point than the default generated application.

### What's in the box?

#### Development

- ๐Ÿณ ย  A [DockerCompose](https://docs.docker.com/compose/) file for running your application database, included in `Procfile.dev`

#### Dependencies

- ๐Ÿ’Ž ย  Up-to-date Crystal dependencies
- ๐Ÿงถ ย  Up-to-date Yarn dependencies

#### Tooling

- ๐Ÿ’จ ย  [TailwindCSS](https://tailwindcss.com) for better styling
- ๐Ÿ–‹ ย  [Tailwind Typography](https://tailwindcss.com/docs/typography-plugin) for prose
- ๐Ÿ“ ย  [Tailwind Forms](https://github.com/tailwindlabs/tailwindcss-forms) to make styling forms easier
- ๐Ÿ–ฅ ย  [Tailwind Aspect Ratio](https://github.com/tailwindlabs/tailwindcss-aspect-ratio) for setting fixed aspect ratios
- ๐ŸŽ‰ ย  [StimulusJS](https://stimulusjs.org) for JavaScript sprinkles
- ๐Ÿš€ ย  [TypeScript](https://typescript.org) for keeping JavaScript cleaner

#### Functionality

- ๐Ÿ“ง ย  Email confirmation of users

#### CI/CD

- ๐Ÿค– ย  A handy dandy [Dependabot](https://dependabot.com/) configuration file, and a workflow to handle auto-merging

- A working GitHub Actions workflow with:
- ๐Ÿ’ƒ ย  [Prettier](https://prettier.io/)
- ๐Ÿ’Ž ย  [Crystal Format](https://crystal-lang.org/reference/using_the_compiler/#crystal-tool-format)
- ๐Ÿฆ  ย  [Ameba](https://github.com/crystal-ameba/ameba)
- ๐Ÿ‘“ ย  [Crystal Spec](https://crystal-lang.org/api/latest/Spec.html)

#### Deployment options

- ๐Ÿณ ย  [Docker](https://www.docker.com), which enables any Dockerfile-based deployment like:
- [Render](https://render.com)
- [Digital Ocean Apps Platform](https://www.digitalocean.com/products/app-platform)
- ๐ŸŸฉ ย  [Render](https://render.com) with a built-in `render.yaml` file
- ๐Ÿ‘พ ย  [Heroku](https://luckyframework.org/guides/deploying/heroku) with a built-in `Procfile` file