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.
 
 
Kate 75c7fbcdbe
Merge pull request #676 from nextcloud/renovate/go_router_builder-2.x
1 year ago
.fvm chore(deps): Update to flutter 3.13.3 1 year ago
.github chore(deps): update docker/setup-buildx-action digest to 885d146 1 year ago
.husky chore(tool): Remove fixup commits workaround 1 year ago
.idea Remove unnecessary IntelliJ files 2 years ago
.vscode feat(tool): add vscode launch config 1 year ago
assets docs: Init 2 years ago
docs chore(docs): Remove disclaimer about login user flow diagram 1 year ago
external chore(tool): Switch to server provided openapi-extractor 1 year ago
packages Merge pull request #676 from nextcloud/renovate/go_router_builder-2.x 1 year ago
tool chore(deps): update nextcloud docker tag to v27.0.2 1 year ago
.gitattributes nextcloud, tool: Generate client using dynamite 2 years ago
.gitignore ignore all coverage reports 2 years ago
.gitmodules chore(tool): Switch to server provided openapi-extractor 1 year ago
CODE_OF_CONDUCT.md feat: Add code of conduct 1 year ago
CONTRIBUTING.md refactor(docs): Move contributing docs to the top level 1 year ago
LICENSE chore: Switch to AGPL-3.0 1 year ago
README.md chore: Update project name 1 year ago
commitlint.yaml feat(neon_lints): add custom linting rules 1 year ago
melos.yaml chore: Update project name 1 year ago
pubspec.yaml chore(deps): update dependency dart to >=3.1.0 <4.0.0 1 year ago

README.md

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.

Contributing

Checkout our contributing docs to get started with developing with Neon.

Development and support

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

Documentation

See docs.

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.