Microsphere Projects — .github

This repository contains the organization-wide community health files and the public profile for the Microsphere Projects GitHub organization.

---

What This Repository Does

GitHub treats a .github repository in an organization as a special location for:

File / Folder	Purpose
profile/README.md	Displayed on the organization's public GitHub profile page
Community health files	Default CONTRIBUTING.md, CODE_OF_CONDUCT.md, ISSUE_TEMPLATE, etc., inherited by every repository in the organization that doesn't define its own

---

About Microsphere Projects

Microsphere is a modern, cloud-native distributed-application platform built on the Java/Spring ecosystem. It addresses the challenges that enterprises face when evolving from monolithic architectures to microservices and cloud-native deployments.

Key Platform Capabilities

Capability	Description
Microservices	Fine-grained, independently deployable services with clear domain boundaries
Cloud Native	First-class support for Kubernetes, Docker, Spring Cloud Alibaba, and Apache Dubbo
High Availability	Distributed architecture targeting 99.999% uptime (< 5.26 min/year downtime)
High Performance	Multi-dimensional optimization across system, configuration, and module layers
Big Data	Built-in monitoring, statistics, and business-intelligence reporting services
Unified Platform	One-stop authentication, authorization, and operations management

---

Projects

All projects are published to Maven Central under the io.github.microsphere-projects group ID.

1. Infrastructure

Project	Build	Coverage	Maven
microsphere-build
microsphere-bom		—
microsphere-java
microsphere-logging

2. Spring Stack

Project	Build	Coverage	Maven
microsphere-spring
microsphere-spring-boot
microsphere-spring-cloud

3. Data Access

Project	Build	Coverage	Maven
microsphere-alibaba-druid
microsphere-mybatis
microsphere-hibernate
microsphere-redis

4. Fault Tolerance

Project	Build	Coverage	Maven
microsphere-alibaba-sentinel
microsphere-resilience4j

5. Integration

Project	Build	Coverage	Maven
microsphere-i18n
microsphere-gateway
microsphere-multiactive

---

Getting Started

Adding Microsphere BOM to Your Project

The recommended way to consume Microsphere libraries is via the Bill of Materials (BOM), which aligns all dependency versions for you.

Maven

<dependencyManagement>
  <dependencies>
    <dependency>
      <groupId>io.github.microsphere-projects</groupId>
      <artifactId>microsphere-bom</artifactId>
      <version>${microsphere-bom.version}</version>
      <type>pom</type>
      <scope>import</scope>
    </dependency>
  </dependencies>
</dependencyManagement>

Gradle (Kotlin DSL)

implementation(platform("io.github.microsphere-projects:microsphere-bom:${microsphereVersion}"))

After importing the BOM you can declare individual modules without specifying a version:

<dependency>
  <groupId>io.github.microsphere-projects</groupId>
  <artifactId>microsphere-spring-boot-autoconfigure</artifactId>
</dependency>

Tip: Check the microsphere-bom releases page for the latest available version.

---

Getting Help

Channel	Link
GitHub Issues	Open an issue in the relevant project repository
Discussions	Use the GitHub Discussions tab of the relevant repository
DeepWiki	Each project has an AI-generated knowledge base — look for the badge on the project page

---

Contributing

We welcome contributions of all kinds — bug reports, documentation improvements, and code changes.

1. Find a project you want to contribute to from the lists above.
2. Read its CONTRIBUTING.md (if present) or open a Discussion to ask where help is most needed.
3. Fork the repository, create a feature branch, and open a pull request against main.
4. All Java projects are built with Maven; run mvn verify locally before submitting.

Community health files in this repository (issue templates, pull-request templates, etc.) are automatically inherited by every Microsphere repository that does not provide its own.

---

License

All Microsphere Projects source code is released under the Apache License 2.0.