finch
Finch is a fast, lightweight Dart framework for building scalable server-side web apps, REST APIs, databases, WebSockets, and MCP servers
1.5.2
17K downloads/mo
#2344 most downloaded on pub.dev
uproid/finch
What this package is like to depend on
Last release 2 days ago
21 Aug 2026
Ships fairly regularly
a new release about every 2 weeks
Nearly every release is documented
notes for 25 of 25 stable releases
1 version withdrawn
withdrawn after publishing
9 months old
27 releases · first in 2025
27 releases in the last 12 months
see the full history below
Release timeline
27 releases · Nov 2025 to Aug 2026Releases
latest 27-
1.5.3-dev.121 Aug 2026 pre-releaseNothing published for this version
-
1.5.214 Aug 2026Release notes
Open source →- Removed the
Request rqparameter fromFinchApp.addRouting()callbacks; request data remains available throughContext.rqinside route handlers - Improved route URL generation and method checks by passing request-specific values explicitly
- Fix issue #80: Support the Previous MCP Protocol Version with an Extended Deprecation Period
- Removed the
-
1.5.2-dev.108 Aug 2026 pre-release withdrawnNothing published for this version
-
1.5.107 Aug 2026Release notes
Open source →1.5.1
- Upgraded MCP support to MCP 2.0 (
mcp_models: 2.0.0): replacedinitialize/notifications/initializedhandling with the newserver/discovermethod andDiscoverResultresponse - Added
make:migrationcommand to create SQL or Dart migration files from the CLIfinch make:migration --name create_users_tablefinch make:migration --name create_users_table --sqlite
- Removed the
--createoption frommigrate/migrate_sqlite; usemake:migrationinstead - Improved the Finch CLI runtime console with command history, arrow-key navigation and line editing (press
hto view history) - Fixed public file serving to reject requests resolving outside the public directory
- Removed the
cryptographypackage dependency - Updated dependencies:
cappto^2.1.0,mcp_modelsto2.0.0 - Added a new real-time "Meeting Room" example (WebSocket-based)
Release notes
Open source →- Upgraded MCP support to MCP 2.0 (
mcp_models: 2.0.0): replacedinitialize/notifications/initializedhandling with the newserver/discovermethod andDiscoverResultresponse - Added
make:migrationcommand to create SQL or Dart migration files from the CLIfinch make:migration --name create_users_tablefinch make:migration --name create_users_table --sqlite
- Removed the
--createoption frommigrate/migrate_sqlite; usemake:migrationinstead - Improved the Finch CLI runtime console with command history, arrow-key navigation and line editing (press
hto view history) - Fixed public file serving to reject requests resolving outside the public directory
- Removed the
cryptographypackage dependency - Updated dependencies:
cappto^2.1.0,mcp_modelsto2.0.0 - Added a new real-time "Meeting Room" example (WebSocket-based)
- Upgraded MCP support to MCP 2.0 (
-
1.5.031 Jul 2026Release notes
Open source →1.5.0
- #75 Added Dart-based migrations as an alternative to SQL migration files
- New
DartMigrationabstract class (up()/down()build SQL viaaddSql()) with atargetofMigrationTarget.mysqlorMigrationTarget.sqlite - Register migrations with
app.registerDartMigration([...]); migration names must be unique migrate --init,--rollbackand--listnow run registered Dart migrations alongside (or instead of) file-based migrations
- New
- #69 Migrations now run inside a database transaction, rolling back automatically if any statement fails
- Multi-statement migrations are executed as separate statements via a new SQL statement splitter
- #74 Removed deprecated dependencies and updated others to their latest versions
- Replaced
mysql_clientwithmysql_client_plus - Replaced
encryptwithcryptography/pointycastlefortoSafe()/fromSafe()AES encryption - Upgraded
mongo_dart,mailer,jinja,intl,build_runner,testandsqlite3
- Replaced
Release notes
Open source →- #75 Added Dart-based migrations as an alternative to SQL migration files
- New
DartMigrationabstract class (up()/down()build SQL viaaddSql()) with atargetofMigrationTarget.mysqlorMigrationTarget.sqlite - Register migrations with
app.registerDartMigration([...]); migration names must be unique migrate --init,--rollbackand--listnow run registered Dart migrations alongside (or instead of) file-based migrations
- New
- #69 Migrations now run inside a database transaction, rolling back automatically if any statement fails
- Multi-statement migrations are executed as separate statements via a new SQL statement splitter
- #74 Removed deprecated dependencies and updated others to their latest versions
- Replaced
mysql_clientwithmysql_client_plus - Replaced
encryptwithcryptography/pointycastlefortoSafe()/fromSafe()AES encryption - Upgraded
mongo_dart,mailer,jinja,intl,build_runner,testandsqlite3
- Replaced
- update to
capp^2.0.0to support for chained command execution #3
- #75 Added Dart-based migrations as an alternative to SQL migration files
-
1.4.421 Jul 2026Release notes
Open source →What's Changed
- 70 error unexpected byte at offset by @uproid in #71
- Fixed map of params by @uproid in #72
- Deploy by @uproid in #73
Full Changelog: v1.4.3...v1.4.4
Release notes
Open source →- #70 Fixed
FormatException: Unexpected extension bytewhen request URLs contain malformed percent-encoded sequences (e.g./%AF/test)- Added
safePathSegmentsextension onUriandsafeDecodeUriComponent()helper for crash-safe decoding of path segments (invalid UTF-8 bytes are replaced with�instead of throwing) - Used safe decoding in route matching, language detection, redirects and public file serving
- Added
-
1.4.311 Jul 2026Release notes
Open source →Fixed ApiDoc to correctly display style route parameters by convertin…
…g them to format in the OpenAPI/Swagger output
Release notes
Open source →- Fixed a WebSocket bug in
SocketManager.requestHandle - Fixed ApiDoc to correctly display
:paramstyle route parameters by converting them to{param}format in the OpenAPI/Swagger output
- Fixed a WebSocket bug in
-
1.4.228 Jun 2026Release notes
Open source →1.4.2
- Added errorWidget to the web app config to enable better customization of error pages. #66
Release notes
Open source →- Added errorWidget to the web app config to enable better customization of error pages. #66
-
1.4.119 Jun 2026Release notes
Open source →1.4.1
- Update dependencies (Sqler 1.2.1), to fix bugs of sqlite queries
1.4.0
- Added new commands to make
controller,middlwareandservicesfinch make:controller --name testfinch make:service --name testfinch make:middleware --name test
- Upgrade dependencies
- Update documents
- added new app tamlates:
finch templates
-
1.4.014 Jun 2026Release notes
Open source →- Added new commands to make
controller,middlwareandservicesfinch make:controller --name testfinch make:service --name testfinch make:middleware --name test
- Upgrade dependencies
- Update documents
- added new app tamlates:
finch templates
- Added new commands to make
-
1.3.306 Jun 2026Release notes
Open source →- Updated documentation to reflect the new
:paramsyntax support in routing #63 - Added comprehensive tests for both classic
{param}and new:paramparameter styles
- Updated documentation to reflect the new
-
1.3.217 May 2026Release notes
Open source →- #58 Fixes #58: Resolved issues in the migrate -i and migrate -r processes. The migration process will now stop if a MySQL error occurs.
- fixing issue for examples
-
1.3.113 May 2026Release notes
Open source →- #54 Fixed a bug in the route caching functionality where responses were not being properly cached and retrieved based
-
1.3.009 May 2026Release notes
Open source →1.3.0
- Added Model Context Protocol (MCP) Server support for building AI-powered applications #49
- Full MCP 2.0 specification implementation with schema handler system
- Automatic JSON serialization/deserialization using factory pattern
- Built-in support for tools, resources, and prompts
- Complete calculator example demonstrating MCP protocol flow
- McpServerController for handling MCP requests and responses
- Updated dependencies to their latest versions for improved performance and security
- Improved documentation to include details about the new MCP Server features and how to use them in Finch applications
- Added new examples demonstrating the usage of the MCP Server in Finch applications
Release notes
Open source →- Added Model Context Protocol (MCP) Server support for building AI-powered applications #49
- Full MCP 2.0 specification implementation with schema handler system
- Automatic JSON serialization/deserialization using factory pattern
- Built-in support for tools, resources, and prompts
- Complete calculator example demonstrating MCP protocol flow
- McpServerController for handling MCP requests and responses
- Updated dependencies to their latest versions for improved performance and security
- Improved documentation to include details about the new MCP Server features and how to use them in Finch applications
- Added new examples demonstrating the usage of the MCP Server in Finch applications
- Added Model Context Protocol (MCP) Server support for building AI-powered applications #49
-
1.2.201 May 2026Release notes
Open source →- Fixes #50. The conflict between watchers in the serve environment has been resolved.
-
1.2.122 Apr 2026Release notes
Open source →- Fixed bugs in route caching functionality to ensure proper caching and retrieval of routes based on the specified parameters and cache source. #46
- Adding language parameter to cache function to specify the language for which the route should be cached, allowing for better support of multilingual applications. #47
-
1.2.022 Apr 2026Release notes
Open source →- Added route caching functionality to improve performance of frequently accessed routes. This includes in-memory caching and file-based caching options, with configurable cache duration and parameters.
- Updated dependencies to their latest versions to ensure compatibility and performance improvements.
- Improved documentation to include details about the new caching features and how to use them.
- Improved the example section to demonstrate the usage of route caching in Finch applications.
-
1.1.414 Apr 2026Release notes
Open source →- Fixes bug of gettting template list in
finch templatescommand in Finch CLI #43 - Updated documentations
- Fixes bug of gettting template list in
-
1.1.312 Apr 2026Release notes
Open source →- Added new command to create migration files for mysql and sqlite databases in Finch CLI
finch migrate --create --mysql --name create_users_table finch migrate --create --sqlite --name create_users_table - Fixs bugs in migration roll back command and added deep option to specify how many migrations should be rolled back in command line
finch migrate --rollback=2 # rolls back the last 2 migrations finch migrate --rollback # rolls back the last migration - Fixed bug of cookies
- Improved the cookie options
- Updated dependencies
- Added
finch templatescommand to show the list of available templates in GitHub #40
- Added new command to create migration files for mysql and sqlite databases in Finch CLI
-
1.1.202 Apr 2026Release notes
Open source →- Adding -template option to Finch CLI to create new projects with different templates
finch create --template simple finch create -t simple - Fixing commands help in Finch CLI
- Adding -template option to Finch CLI to create new projects with different templates
-
1.1.126 Mar 2026Release notes
Open source →- Updated the Finch CLI to create new projects in new paths
- Fixed the example
- Added new extension for CappManager to write help in a modern way
- Added new command for build cli in Finch CLI
finch build --cli --path ./lib/app.dart
-
1.1.013 Mar 2026Release notes
Open source →- Added Finch serve CLI command to serve to run watch mode for development
finch serve - Improved the example section
- Fixed Finch CLI
- #29 New ability to serve all languages json files to one dart file
- #29 New ability to serve all widget files to one dart file
- Fixed asset managers for duplicated assets
- Developed Middleware #30 classes for routes to have more control on routes
- Fixed Console debugger in frontend
- Fixed swagger UI
- Updated dependencies
- Added Finch serve CLI command to serve to run watch mode for development
-
1.0.422 Dec 2025 -
1.0.302 Dec 2025 -
1.0.220 Nov 2025Release notes
Open source →- Updated documentation for localization and i18n (EN/FA/ZH) #16
- Added new feauture for i18n with dart language source #16
-
1.0.116 Nov 2025Release notes
Open source →- Improved documentations (EN/FA/ZH) #12
- Fixed addCookie, removeCookie & getLanguage #11
-
1.0.002 Nov 2025Release notes
Open source →- First release of Finch
- The Finch package was developed as an adaptation of the WebApp package. We made extensive improvements to WebApp, focusing on simplicity in coding and overall stability, and released the enhanced version under the name Finch. From now on, all future updates will be made to this package, and WebApp will soon be deprecated.