Skip to content

dimamik/phenom

Repository files navigation

Phenom logo

License - MIT Hex version Deploy to Fly Deploy on VPS

Phenom

An opinionated Phoenix starter designed for speed without sacrificing quality. Spin up a PoC in minutes, then scale it into a production-grade application — the foundation is already there.

Built-in patterns help you (and your AI coding agents) extend the app while following industry best practices, so you write better software from day one.

Getting started

# 1. Install the generator as a Mix archive (if not already)
mix archive.install hex phenom --force

# 2. Generate a new app
mix phenom.new my_new_app

# 3. Set it up and run it
cd my_new_app
mix setup
mix phx.server

What's included

  1. Web - Phoenix with LiveView
  2. Database - Ecto with Postgres
  3. Jobs - Oban and Oban Web (dashboard)
  4. HTTP Requests - Req
  5. Code Analysis - Credo and Sobelow
  6. CI/CD - GitHub Actions and Fly.io or your own VPS (e.g. Hetzner) with GHCR docker images (included)

What will be included in the future

  1. Safer default CSP settings (so we don't need to skip them in Sobelow)
  2. Live Debugger
  3. A way to test Req requests
  4. Observability configuration (ideally - something free or self-hosted)
  5. A way to define new views/components, so LLMs follow established patterns
  6. Authorization (Probably some variation of Phoenix auth). Use password-first approach, since emails are harder to set up
  7. Better LLM instructions and pre-defined tooling
  8. Improved favicons for better branding
  9. And many, many more

Contributing

Feel free to open an issue or submit a pull request if you find bugs or want to contribute improvements!

Learn More

About

Opinionated template for your new Phoenix project

Topics

Resources

License

Stars

Watchers

Forks

Packages

 
 
 

Contributors