# .github

**Repository Path**: microsphere-projects/.github

## Basic Information

- **Project Name**: .github
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Apache-2.0
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-09-03
- **Last Updated**: 2026-09-05

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# Microsphere Projects — `.github`

[![License](https://img.shields.io/github/license/microsphere-projects/.github.svg)](LICENSE)

This repository contains the **organization-wide community health files** and the **public profile** for the [Microsphere Projects](https://github.com/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](https://search.maven.org/search?q=io.github.microsphere-projects) under the `io.github.microsphere-projects` group ID.

### 1. Infrastructure

| Project | Build | Coverage | Maven |
|---|---|---|---|
| [microsphere-build](https://github.com/microsphere-projects/microsphere-build) | [![Build](https://github.com/microsphere-projects/microsphere-build/actions/workflows/maven-build.yml/badge.svg)](https://github.com/microsphere-projects/microsphere-build/actions/workflows/maven-build.yml) | [![Codecov](https://codecov.io/gh/microsphere-projects/microsphere-build/branch/main/graph/badge.svg)](https://app.codecov.io/gh/microsphere-projects/microsphere-build) | ![Maven](https://img.shields.io/maven-central/v/io.github.microsphere-projects/microsphere-build.svg) |
| [microsphere-bom](https://github.com/microsphere-projects/microsphere-bom) | [![Build](https://github.com/microsphere-projects/microsphere-bom/actions/workflows/maven-build.yml/badge.svg)](https://github.com/microsphere-projects/microsphere-bom/actions/workflows/maven-build.yml) | — | ![Maven](https://img.shields.io/maven-central/v/io.github.microsphere-projects/microsphere-bom.svg) |
| [microsphere-java](https://github.com/microsphere-projects/microsphere-java) | [![Build](https://github.com/microsphere-projects/microsphere-java/actions/workflows/maven-build.yml/badge.svg)](https://github.com/microsphere-projects/microsphere-java/actions/workflows/maven-build.yml) | [![Codecov](https://codecov.io/gh/microsphere-projects/microsphere-java/branch/main/graph/badge.svg)](https://app.codecov.io/gh/microsphere-projects/microsphere-java) | ![Maven](https://img.shields.io/maven-central/v/io.github.microsphere-projects/microsphere-java.svg) |
| [microsphere-logging](https://github.com/microsphere-projects/microsphere-logging) | [![Build](https://github.com/microsphere-projects/microsphere-logging/actions/workflows/maven-build.yml/badge.svg)](https://github.com/microsphere-projects/microsphere-logging/actions/workflows/maven-build.yml) | [![Codecov](https://codecov.io/gh/microsphere-projects/microsphere-logging/branch/main/graph/badge.svg)](https://app.codecov.io/gh/microsphere-projects/microsphere-logging) | ![Maven](https://img.shields.io/maven-central/v/io.github.microsphere-projects/microsphere-logging.svg) |

### 2. Spring Stack

| Project | Build | Coverage | Maven |
|---|---|---|---|
| [microsphere-spring](https://github.com/microsphere-projects/microsphere-spring) | [![Build](https://github.com/microsphere-projects/microsphere-spring/actions/workflows/maven-build.yml/badge.svg)](https://github.com/microsphere-projects/microsphere-spring/actions/workflows/maven-build.yml) | [![Codecov](https://codecov.io/gh/microsphere-projects/microsphere-spring/branch/main/graph/badge.svg)](https://app.codecov.io/gh/microsphere-projects/microsphere-spring) | ![Maven](https://img.shields.io/maven-central/v/io.github.microsphere-projects/microsphere-spring.svg) |
| [microsphere-spring-boot](https://github.com/microsphere-projects/microsphere-spring-boot) | [![Build](https://github.com/microsphere-projects/microsphere-spring-boot/actions/workflows/maven-build.yml/badge.svg)](https://github.com/microsphere-projects/microsphere-spring-boot/actions/workflows/maven-build.yml) | [![Codecov](https://codecov.io/gh/microsphere-projects/microsphere-spring-boot/branch/main/graph/badge.svg)](https://app.codecov.io/gh/microsphere-projects/microsphere-spring-boot) | ![Maven](https://img.shields.io/maven-central/v/io.github.microsphere-projects/microsphere-spring-boot.svg) |
| [microsphere-spring-cloud](https://github.com/microsphere-projects/microsphere-spring-cloud) | [![Build](https://github.com/microsphere-projects/microsphere-spring-cloud/actions/workflows/maven-build.yml/badge.svg)](https://github.com/microsphere-projects/microsphere-spring-cloud/actions/workflows/maven-build.yml) | [![Codecov](https://codecov.io/gh/microsphere-projects/microsphere-spring-cloud/branch/main/graph/badge.svg)](https://app.codecov.io/gh/microsphere-projects/microsphere-spring-cloud) | ![Maven](https://img.shields.io/maven-central/v/io.github.microsphere-projects/microsphere-spring-cloud.svg) |

### 3. Data Access

| Project | Build | Coverage | Maven |
|---|---|---|---|
| [microsphere-alibaba-druid](https://github.com/microsphere-projects/microsphere-alibaba-druid) | [![Build](https://github.com/microsphere-projects/microsphere-alibaba-druid/actions/workflows/maven-build.yml/badge.svg)](https://github.com/microsphere-projects/microsphere-alibaba-druid/actions/workflows/maven-build.yml) | [![Codecov](https://codecov.io/gh/microsphere-projects/microsphere-alibaba-druid/branch/main/graph/badge.svg)](https://app.codecov.io/gh/microsphere-projects/microsphere-alibaba-druid) | ![Maven](https://img.shields.io/maven-central/v/io.github.microsphere-projects/microsphere-alibaba-druid.svg) |
| [microsphere-mybatis](https://github.com/microsphere-projects/microsphere-mybatis) | [![Build](https://github.com/microsphere-projects/microsphere-mybatis/actions/workflows/maven-build.yml/badge.svg)](https://github.com/microsphere-projects/microsphere-mybatis/actions/workflows/maven-build.yml) | [![Codecov](https://codecov.io/gh/microsphere-projects/microsphere-mybatis/branch/main/graph/badge.svg)](https://app.codecov.io/gh/microsphere-projects/microsphere-mybatis) | ![Maven](https://img.shields.io/maven-central/v/io.github.microsphere-projects/microsphere-mybatis.svg) |
| [microsphere-hibernate](https://github.com/microsphere-projects/microsphere-hibernate) | [![Build](https://github.com/microsphere-projects/microsphere-hibernate/actions/workflows/maven-build.yml/badge.svg)](https://github.com/microsphere-projects/microsphere-hibernate/actions/workflows/maven-build.yml) | [![Codecov](https://codecov.io/gh/microsphere-projects/microsphere-hibernate/branch/main/graph/badge.svg)](https://app.codecov.io/gh/microsphere-projects/microsphere-hibernate) | ![Maven](https://img.shields.io/maven-central/v/io.github.microsphere-projects/microsphere-hibernate.svg) |
| [microsphere-redis](https://github.com/microsphere-projects/microsphere-redis) | [![Build](https://github.com/microsphere-projects/microsphere-redis/actions/workflows/maven-build.yml/badge.svg)](https://github.com/microsphere-projects/microsphere-redis/actions/workflows/maven-build.yml) | [![Codecov](https://codecov.io/gh/microsphere-projects/microsphere-redis/branch/main/graph/badge.svg)](https://app.codecov.io/gh/microsphere-projects/microsphere-redis) | ![Maven](https://img.shields.io/maven-central/v/io.github.microsphere-projects/microsphere-redis.svg) |

### 4. Fault Tolerance

| Project | Build | Coverage | Maven |
|---|---|---|---|
| [microsphere-alibaba-sentinel](https://github.com/microsphere-projects/microsphere-alibaba-sentinel) | [![Build](https://github.com/microsphere-projects/microsphere-alibaba-sentinel/actions/workflows/maven-build.yml/badge.svg)](https://github.com/microsphere-projects/microsphere-alibaba-sentinel/actions/workflows/maven-build.yml) | [![Codecov](https://codecov.io/gh/microsphere-projects/microsphere-alibaba-sentinel/branch/main/graph/badge.svg)](https://app.codecov.io/gh/microsphere-projects/microsphere-alibaba-sentinel) | ![Maven](https://img.shields.io/maven-central/v/io.github.microsphere-projects/microsphere-alibaba-sentinel.svg) |
| [microsphere-resilience4j](https://github.com/microsphere-projects/microsphere-resilience4j) | [![Build](https://github.com/microsphere-projects/microsphere-resilience4j/actions/workflows/maven-build.yml/badge.svg)](https://github.com/microsphere-projects/microsphere-resilience4j/actions/workflows/maven-build.yml) | [![Codecov](https://codecov.io/gh/microsphere-projects/microsphere-resilience4j/branch/main/graph/badge.svg)](https://app.codecov.io/gh/microsphere-projects/microsphere-resilience4j) | ![Maven](https://img.shields.io/maven-central/v/io.github.microsphere-projects/microsphere-resilience4j.svg) |

### 5. Integration

| Project | Build | Coverage | Maven |
|---|---|---|---|
| [microsphere-i18n](https://github.com/microsphere-projects/microsphere-i18n) | [![Build](https://github.com/microsphere-projects/microsphere-i18n/actions/workflows/maven-build.yml/badge.svg)](https://github.com/microsphere-projects/microsphere-i18n/actions/workflows/maven-build.yml) | [![Codecov](https://codecov.io/gh/microsphere-projects/microsphere-i18n/branch/main/graph/badge.svg)](https://app.codecov.io/gh/microsphere-projects/microsphere-i18n) | ![Maven](https://img.shields.io/maven-central/v/io.github.microsphere-projects/microsphere-i18n.svg) |
| [microsphere-gateway](https://github.com/microsphere-projects/microsphere-gateway) | [![Build](https://github.com/microsphere-projects/microsphere-gateway/actions/workflows/maven-build.yml/badge.svg)](https://github.com/microsphere-projects/microsphere-gateway/actions/workflows/maven-build.yml) | [![Codecov](https://codecov.io/gh/microsphere-projects/microsphere-gateway/branch/main/graph/badge.svg)](https://app.codecov.io/gh/microsphere-projects/microsphere-gateway) | ![Maven](https://img.shields.io/maven-central/v/io.github.microsphere-projects/microsphere-gateway.svg) |
| [microsphere-multiactive](https://github.com/microsphere-projects/microsphere-multiactive) | [![Build](https://github.com/microsphere-projects/microsphere-multiactive/actions/workflows/maven-build.yml/badge.svg)](https://github.com/microsphere-projects/microsphere-multiactive/actions/workflows/maven-build.yml) | [![Codecov](https://codecov.io/gh/microsphere-projects/microsphere-multiactive/branch/main/graph/badge.svg)](https://app.codecov.io/gh/microsphere-projects/microsphere-multiactive) | ![Maven](https://img.shields.io/maven-central/v/io.github.microsphere-projects/microsphere-multiactive.svg) |

---

## 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**

```xml
<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)**

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

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

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

> **Tip:** Check the [microsphere-bom releases](https://github.com/microsphere-projects/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](https://github.com/orgs/microsphere-projects/discussions) tab of the relevant repository |
| **DeepWiki** | Each project has an AI-generated knowledge base — look for the [![Ask DeepWiki](https://deepwiki.com/badge.svg)](https://deepwiki.com/microsphere-projects) 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](LICENSE).