A framework for building convergent cross-platform Nextcloud clients using Flutter.
You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
 
 
Nikolas Rimikis 6a94a9c21d
dynamite: migrate enum to built_value
2 years ago
.fvm Update flutter to 3.10 2 years ago
.github/workflows Fix paths after packages refactoring 2 years ago
.idea Split neon into multiple packages 2 years ago
.vscode make vscode use fvm 2 years ago
assets Update Readme 2 years ago
external Update nextcloud server and notifications to 26.0.1 2 years ago
packages dynamite: migrate enum to built_value 2 years ago
specs specs,nextcloud: Add endpoint for deleting app password 2 years ago
tool Update Readme 2 years ago
.gitattributes nextcloud, tool: Generate client using dynamite 2 years ago
.gitmodules app: Build flatpaks 2 years ago
LICENSE Update username 2 years ago
README.md Update Readme 2 years ago
mono_repo.yaml Separate analyze CI jobs 2 years ago

README.md

nextcloud-neon

Neon logo

A framework for building convergent cross-platform Nextcloud clients using Flutter.

Features

See here for screenshots.

  • Supported
  • 🚀 Planned
App Status
Files
News
Notes
Notifications
Activity 🚀
Calendar 🚀
Contacts 🚀
Cookbook 🚀
Dashboard 🚀
Photos 🚀
Talk 🚀
Tasks 🚀

Problems with other clients and how this project tries to solve them

Current problems with other clients

Excerpt from my job application to Nextcloud:

  • There are many clients that are designed to run exclusively on a single platform or device type. They all have different code bases, which makes feature parity and maintenance much more difficult.
  • The user experience and features differ significantly from platform to platform, which leads to frustration. This particularly affects mobile devices running Linux (e.g. postmarketOS). There is no suitable client on this platform at all. Using the desktop Linux client for file synchronization would probably work, but this platform still lacks almost all the features available on e.g. Android and the client is not made for mobile screens. Someone who uses Linux on their mobile device is likely also interested in Nextcloud, so the need for a solution is definitely there.
  • Even on feature-rich platforms, features are spread across multiple apps (e.g. on Android), making it more complicated for the user who simply wants to get the most out of their Nextcloud server on their device.

How Neon as a framework tries to solve them

This project uses OpenAPI specifications to generate all the necessary API client code. This vastly reduces the developer efforts of writing a lot of boilerplate code and having to look at the PHP source code. Most server APIs were not well or at all documented until now (there are some exceptions). Based on this work a project at the Nextcloud company started for adopting OpenAPI to document the server APIs. The OpenAPI specifications are generated completely automated from the source code (although some changes to the type annotations are required) and are validated with static analysis of the PHP code. These efforts are not done yet, but this project basically became the front-line for testing the automatically generated specifications.

We use flutter because of its cross-platform capabilities. To decrease the developer burden, a lot of useful widgets and utilities have been developed, so that they can be re-used. Trying to make everything re-usable is a major goal of this project, as we want to close the gap between platforms and functionalities and make development of new clients and apps enjoyable and fast. Developing a new Nextcloud client can be as easy as adding some UI and then necessary state management, everything else is taken care of for you.

Development and support

We have a Matrix space where you can ask questions: https://matrix.to/#/#nextcloud-neon:matrix.org

Architecture overview

Architecture overview diagram

The framework consists of multiple packages:

  • For APIs the nextcloud package provides the implementations. The dynamite generator generates the code using the OpenAPI specs.
  • The main package is the neon package that provides widgets and functionality that is useful for building a Nextcloud client. It also manages the global state at runtime so that the app implementations do not have to manage things like multiple accounts for example.
  • The individual apps are implemented as separate packages. Those depend on the neon framework and implement a few interfaces so that the neon framework can use them.
  • On top of all that sits the app package that injects the relevant app implementations into the framework. It is possible to configure which app implementations should be included and how the app is branded.

Platform support

Except for web, Neon should run on all supported Flutter platforms in the future.
Right now this is not the case, only Android and Linux are supported and tested, but this can easily be extended to other platforms.

The features and problems of all platforms should be considered when implementing new features.