Skip to content
An efficient gson-based library which widely allows maintaining JSON in many different ways, locally and remotely!
Branch: master
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Type Name Latest commit message Commit time
Failed to load latest commit information.



SimpleJSON is a wide, feature-extensive JSON/GSON library which aims on simplifying loads of JSON operations, which makes dealing with JSON a piece of cake.


  • Extremely easy to use
  • Well-documented code
  • Easily read, write and handle JSON from any file or URL, using a basic reader, a basic configuration or a complex configuration.
  • Different JSON utilities for simplifying building JSON.
  • Clean, easy-to-read and heavily-documented code.
  • Built and implemented to be thread-safe. This library supports running in multi-threaded environments.
  • Outstanding performance and very fast.

Using the library

Setting up the project to use SimpleJSON is explained in details in this wiki page.

The library is configured to produce javadoc and sources JARs. This should allow you to browse JavaDocs from your project directly.


If your project does not use a build system like Maven or Gradle, then you should consider adding JAR files to your classpath instead.

Examples & Wiki

Every entity and class in this library is explained in details in SimpleJSON's wiki. The wiki includes examples on the usage of each of them



If you would like to contribute to SimpleJSON, please keep in mind a few things:

  • Code cleanliness, readability and format
  • Appropriate JavaDocs
  • Warning-free code
  • Thread-safe objects
  • Generally abiding by Java's good practices and avoiding bad practices.

As for contributing, it's heavily preferred if you use IntelliJ IDEA, as it encourages great practices and the entire project's formatting is based on IntelliJ IDEA's formatter.

Setting up workspace:

  • Fork the repository
  • Simply clone your fork of the repository: git clone
  • Do your modifications freely to the code
  • Create a pull request which contains your changes and commits.


  • The main JAR is produced using the gradle build command.
  • JavaDoc JAR is produced using the gradle javadocJar command.
  • Sources JAR is produced using the gradle sourcesJar command.


SimpleJSON is not maintained, sponsored nor affiliated with GSON and is an independent project maintained by (an) independent developer(s).

SimpleJSON is licensed under Apache 2.0 license. License terms are found in the LICENSE file.

You can’t perform that action at this time.