Open Source

hello.world
Simple Finch App

A lightweight, modern Dart web application built with the Finch framework and containerized with Docker for seamless deployment.

View on GitHub Visit Website

Documentation

Everything you need to get started with the Finch framework.

Quick Start

Get up and running in seconds. Clone the repository and start the development server with Docker Compose:

# Clone the repository
git clone https://github.com/uproid/simple-finch-docker.git
cd simple-finch-docker

# Start with Docker Compose
docker compose up --build

Project Structure

The project follows a clean and intuitive structure. Controllers handle your routes, widgets define your templates with Jinja2 syntax, and language files power the built-in i18n support.

lib/
  ├── app.dart           # Entry point & server setup
  ├── serve.dart         # File watcher for development
  ├── controllers/       # Route controllers
  ├── widgets/           # Jinja2 HTML templates
  └── languages/         # i18n JSON files

Finch Framework

Finch is a lightweight Dart web framework that provides routing, middleware, template rendering, and internationalization out of the box. It is designed for building fast, modern server-side applications with minimal boilerplate.

Explore the full framework documentation and source code on GitHub.

Deployment

The included Dockerfile and docker-compose.yaml make it easy to deploy anywhere that supports containers. Build for production and expose on your preferred port:

# Build and run in production
docker compose -f docker-compose.yaml up -d