For AI agents: the complete documentation index is available at https://payhon.github.io/AppKernia/en-US/llms.txt, the full documentation bundle is available at https://payhon.github.io/AppKernia/en-US/llms-full.txt, and this page is available as Markdown at https://payhon.github.io/AppKernia/en-US/index.md.
AppKernia

MIT open source · Mobile + Admin + ServerBuild every side of your app as one system

Build Android, iOS, and HarmonyOS with uni-app x, run operations in React, and serve APIs with Go and PostgreSQL. Mobile, admin, and server share one contract from day one.

Install akoneView on GitHub
AppKernia React Admin dashboard
Signed-in AppKernia Mobile home screen
AppKernia Mobile profile screen

AppKernia core value

WHY APPKERNIA

Building an app should not begin by stitching together three starters

I kept meeting the same problem from one app project to the next: mobile frameworks, Admin templates, and server scaffolds are all abundant. But once a product needs Android, iOS, HarmonyOS, operations, permissions, files, notifications, and dependable APIs, developers are still left to bridge every seam.

That is why I started AppKernia. It is not another framework that tries to own every decision. It connects the foundation every app team rebuilds, so you can reach the problems that are unique to your product sooner.

01

A complete system from the start

Mobile, Admin, and Server share contracts. Each layer knows its responsibility and how it works with the other two.

02

Keep repeated work in the foundation

Security, i18n, authorization, state, and engineering become defaults, returning development time to product experience.

03

Maintain it with developers for the long run

Explicit contracts, stable dependencies, and evolvable structure make the project easier to understand, extend, and improve together.

ONE FOUNDATION · THREE SURFACES

One repository connects every side of the app

These are not three templates placed next to each other. Routes, identity, locale, authorization, and error codes move through one contract while each surface focuses on what it does best.

M

AK Mobile

A uni-app x foundation for Android, iOS, and HarmonyOS NEXT with typed networking, secure storage, static routes, and an AK UI layer.

uni-app x · UTS/UVue · VDOM · AK UI
A

AK Admin

An operations console built around real permissions, organizations, multi-tenancy, and safe administrative workflows.

React · Vite · TanStack · Ant Design
S

AK Server

A PostgreSQL-first modular Go backend with OpenAPI contracts, rotating sessions, audit, jobs, files, and notification modules.

GoFrame · pgx/sqlc · PostgreSQL · River

BUILT ON PROVEN TOOLS

One stack, with every tool doing what it does best

uni-app x connects mobile platforms, React shapes the operations experience, Go and PostgreSQL carry the business and its data, and OpenAPI keeps every surface speaking the same language.

  • uni-app x logouni-app xMobile
  • ReactAdmin
  • TypeScriptAdmin
  • ViteAdmin
  • GoServer
  • PostgreSQLData
  • OpenAPIContract
  • DockerRuntime
  • Ant DesignAdmin UI

CORE FEATURES

Give the shared problems to the foundation and your time to the product

Identity, authorization, data, releases, and internationalization follow the same rules, so you can shape the business instead of repeatedly repairing the seams between surfaces.

01

Session security

Access Tokens, Refresh Token rotation, audience isolation, and secure client storage form one coherent path.

Explore authentication →02

Authorization and tenancy

The frontend delivers a clear experience while Backend and SQL own authorization and tenant isolation, keeping one source of truth for access.

Explore the permission model →03

End-to-end i18n

zh-CN and en-US span API, Admin, Mobile, and docs with stable error codes and fallback rules.

Understand the locale contract →04

OpenAPI contracts

Routes, requests, responses, and errors flow from the server source of truth into generated clients.

Browse the API →05

AK UI adaptation

Shared components and Props, Event, and Slot contracts isolate mobile pages from platform details.

View mobile components →06

A maintainable engineering baseline

Migrations, tests, CI, and bilingual documentation evolve with the code, helping new contributors join one shared workflow.

Read the development guide →

CAPABILITY MATRIX

One capability, three clear responsibilities

From sign-in to content publishing, follow one row to see how Mobile, Admin, and Server divide the work.

CapabilityMobileAdminServer
Identity and sessionsDevice identity, secure storage, refresh coordinationSecure cookies, session and MFA managementAudience isolation, rotation, revocation
Authorization and tenancyCapability gates and stable error codesMenu, action, and data-scope UXServer authorization and SQL tenant filters
Content and operationsArticles, notifications, versions, profileContent, files, jobs, settings, auditVersioned content, object storage, workers
InternationalizationAkI18n, navigation, system formatsi18next, Ant Design, Day.jsLocaleResolver and embedded catalogs

QUICK START

Install one binary, then open Admin in two steps

akone embeds Admin and uses SQLite by default. Choose the installation method for your system to get started.

Release status: Shell, npm, and manual downloads await the first Preview; Homebrew awaits a stable release. For now, use the default Source build tab.

0.5.0

For macOS and Linux on amd64 or arm64; the installer verifies SHA-256.

curl -fsSL https://static.appkernia.com/akone/latest.sh | sh
export PATH="$HOME/.local/bin:$PATH"
akone version --json

The installer verifies the archive checksum, archive version, and embedded binary version.

The commands below assume akone is on PATH. The Source and Shell tabs set that path for the current terminal.

1

Create an administrator

The password is read from a hidden terminal prompt and never written to shell history.

akone bootstrap-admin --email admin@example.com --tenant-code local --tenant-name "Local Workspace" --display-name Administrator
Enter Go and React source developmentUse the complete Docker development stack

PRODUCT, END TO END

From the operations console to the phone, grow one product across every surface

Manage applications, content, releases, and storage in Admin, then carry sign-in, notifications, reading, and account experiences into Mobile. Both surfaces meet through the same API and product rules.

Applications page in AppKernia React Admin

Applications

Organize application settings, team access, and daily operations in one place.
Applications, 1 / 4
AppKernia Mobile sign-in screen

Secure sign-in

Identity, sessions, and locale start working together at the mobile entry point.
Secure sign-in, 1 / 4

FAQ

Questions before you begin

Is AppKernia a low-code platform?

No. It is an auditable, extensible engineering foundation and contract system. Product behavior is still implemented in Go, React, and UTS/UVue.

What stage of project is AppKernia for?

Use it to evaluate full-stack app architecture, start a new project, or help shape an open-source foundation. AppKernia is still in 0.x and will evolve quickly; before launch, complete the security, performance, backup, and platform testing your product needs.

Why call out HarmonyOS?

Because HarmonyOS should not be the platform a cross-platform stack adds last. AppKernia puts HarmonyOS NEXT on the main mobile path, so components, routes, networking, and engineering conventions evolve together.

Can I contribute without Go or UTS expertise?

Absolutely. Reproduce an issue, improve docs, review a design, add tests, check platform compatibility, or refine a translation. The community guide takes you from a first small change to a code contribution.

BUILD WITH US

If this direction solves a problem for you, help make it better

From opening an issue and clarifying a paragraph to adding a component or platform adaptation, every contribution helps the next developer start more easily. If you like AppKernia, leave a Star on GitHub so more people looking for a complete app foundation can find it.

Star on GitHubStart contributingView the roadmap