Machines UI

A modern dashboard for managing your Fly.io resources through the Machines API. This dashboard provides a clean interface for monitoring and managing your Fly Apps, Machines, and volumes.

Features

• Authentication: Securely authenticate with your Fly.io API token
• Apps Management: View, search, and manage your Fly.io applications
• Machines Management: Monitor, filter, and control your virtual machines
• Volumes Management: View and manage your persistent storage volumes
• Responsive Design: Works across desktop and mobile devices

Prerequisites

• A Fly.io account with API access
• Node.js 18+ and bun 1.0.0+

Getting Started

1. Clone the repository

   git clone https://github.com/kylemclaren/machines-ui.git
   cd machines-ui

2. Install dependencies

   bun install

3. Run the development server

   bun run dev

4. Open http://localhost:3000 in your browser

Authentication

To use the dashboard, you'll need to authenticate with your Fly.io API token:

1. Download the Fly CLI
2. Generate an API token with fly tokens create org
3. Enter your token in the login screen of the dashboard

Deploy to Fly.io

To deploy the app tp Fly.io, simply run:

fly launch --from https://github.com/kylemclaren/machines-ui.git

API Documentation

This dashboard is built on top of the official Fly.io Machines API. For more information on the API endpoints and capabilities, refer to the official documentation.

Tech Stack

• Next.js 15: React framework for server-side rendering and static site generation
• React 19: UI library for building component-based interfaces
• TailwindCSS 4: Utility-first CSS framework
• React Query: Data fetching and state management
• Axios: HTTP client for API requests

License

This project is licensed under the MIT License - see the LICENSE file for details.

Acknowledgements

• Fly.io for the Machines API
• shadcn for UI components