<p align="center">
	<img src="https://raw.githubusercontent.com/dimamik/phenom/main/img/logo-rich.png" alt="Phenom logo" width="160" />
</p>

<p align="center">
	<a href="https://github.com/dimamik/phenom/blob/main/LICENSE"><img src="https://img.shields.io/badge/license-MIT-green" alt="License - MIT" /></a>
	<a href="https://hex.pm/packages/phenom"><img src="https://img.shields.io/hexpm/v/phenom.svg" alt="Hex version" /></a>
	<a href="https://github.com/dimamik/phenom/blob/main/deployment/fly/README.md"><img src="https://img.shields.io/badge/Deploy%20to-Fly-blueviolet?logo=fly.io" alt="Deploy to Fly" /></a>
	<a href="https://github.com/dimamik/phenom/blob/main/deployment/vps/README.md"><img src="https://img.shields.io/badge/Deploy%20on-VPS-blue?logo=docker" alt="Deploy on VPS" /></a>
</p>

# 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

```bash
# 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
```

---

For more information about the template, visit the [project repository](https://github.com/dimamik/phenom).