Skip to main content
Sparrow Zoo麻雀窝
SPARROW ZOO · A CONNECTED ECOSYSTEM

One ecosystem.
From scaffolding to an AI agent platform.

A shared engineering foundation for identity, files, access control, and real-time communication. Build on reusable capabilities and bring your next application to life.

Explore productsRead the docs

Java / Spring Boot · React / Next.js

07 / Ecosystem products
14 / Development guides
Spring Boot + ReactEngineering foundation

PRODUCTS / THE BUILDING BLOCKS

From foundations to application services

Choose the capabilities your application needs. Explore available services and see what's in development.

Foundation

Sparrow Scaffold

Project Scaffold

A clear approach to build standards: Parent for the baseline, BOM for component versions, and Starter for integration. Give component evolution and application adoption a shared direction.

JavaSpring BootParent / BOMStarter
Read the engineering guide
Complete

Unified Identity

Passport Identity

A shared entry point for sign-in, registration, and password recovery, with options for separate frontends and monolithic applications.

Sign-in & registrationPassword recoveryShared identity
02Explore the product
Complete

File Storage

File Service

Upload and store files through a shared interface, with drag and drop, progress tracking, previews, and storage paths for different use cases.

Drag and dropUpload progressFile previews
03Explore the product
In development

Access Control

Security

Shared access control built around roles, permissions, and resources, with authentication and authorization capabilities in development.

RBACAuthorizationResource isolation
04In development
Complete

Sparrow IM

Instant Messaging

A messaging service for direct chats, group conversations, and notifications, informed by connection and message handling practices.

Direct & group chatsNotificationsWebSocket
05Explore the product
Complete

Sparrow Coder

Code Generator

Turn entity models into CRUD code for Clean Architecture backends and React frontends, reducing repetitive implementation work.

CRUDClean ArchitectureReact
06Explore the product
Complete

UI Components

UI Components

React and Next.js component examples — forms, tables, uploads and drag-and-drop — ready to reuse in your projects.

ReactNext.jsComponents
07Explore the product

DOCUMENTATION / ENGINEERING NOTES

Build on what we've learned

Explore architecture decisions, integration guides, and debugging notes drawn from the project's engineering work.

Guide content is currently available in Chinese.

14 guides
Web Storage / RPC

Web Storage and Cross-Origin SSO: From Safari Differences to Client RPC

Explain how Cookie tokens or server sessions remove same-site SSO's dependence on shared iframe storage. Compare shared Domain cookies with API host-only HttpOnly cookies, including authentication changes, credentialed requests, and cross-site limits.

Frontend / React
Nginx

Enabling HTTPS across the site with Nginx

Unify public domains on 443 SSL with 80→301 redirects, keep internal domains on 80, and use certbot certonly to issue certificates before rolling out config.

Backend / Nginx
React

Embedding React into non-React pages

Mount a customer-service widget into non-React sites using createRoot and useEffect, and understand how HTML fragments are generated and injected.

Frontend / React
Nginx

Next.js 15 four-site static launch

Build one archive locally, switch releases on the server with a single command, plus verification and pitfalls.

Backend / Nginx
SMTP / IMAP

Complete Tencent Exmail configuration guide

Check administrator and member permissions, create client passwords, connect mail clients and Java applications, and diagnose 535 authentication errors.

Backend / Mail
Maven

Sparrow Parent and BOM

Separate build baselines, component versions, and application adoption, with complete POM examples.

Backend / Java
OpenAPI

Integrating springdoc-openapi

Understand Servlet MVC and WebFlux stacks and select the matching API documentation dependency.

Backend / Java
OpenAPI

OpenAPI grouping strategies

Resolve configuration conflicts across starters and create separate API groups for File and Passport.

Backend / Java
Maven

Maven sources and breakpoint debugging

Trace misplaced breakpoints to source packages and bytecode line tables, from publishing to local debugging.

Backend / Java
Netty

Netty inbound messages and OOM

Follow a handler case study to find unreleased references, memory leaks, and heartbeat failures.

Backend / Java
Netty

Netty memory sharing and release

Explore reference counting, zero-copy sharing, and deep copies to clarify memory ownership in message forwarding.

Backend / Java
Thymeleaf

Thymeleaf template paths

Diagnose missing templates caused by double slashes when a prefix meets a view name.

Backend / Java
React

The useCaptcha React Hook

Walk through session setup, image loading, and refresh behavior, including cleanup and retry boundaries.

Frontend / React
Next.js

Internationalization with next-intl

Connect locale routing, middleware, and message context, with guidance on grouped translations and troubleshooting.

Frontend / React

WHY SPARROW / SHARED CAPABILITIES

Common capabilities, growing together

Turn recurring engineering problems into reusable foundations, from backend components to shared frontend libraries.

Shared identity

Connect application entry points through Passport authentication and shared sign-in state across domains.

Engineering standards

Give build standards, version management, and framework integration clear roles through Parent, BOM, and Starter.

Real-time connections

Build on practical work with WebSocket heartbeats, reconnection, and Netty message handling.

Compose as needed

Combine shared protocols, independent components, and frontend capabilities with room to extend each application.

START BUILDING / YOUR NEXT STEP

Start with the engineering foundation

Understand the Sparrow approach and find the services and practices that fit your application.

Read the engineering guideBrowse all guides