chore: add repo common files
diff --git a/java-core/README.md b/java-core/README.md
new file mode 100644
index 0000000..d65c275
--- /dev/null
+++ b/java-core/README.md
@@ -0,0 +1,63 @@
+# Google Cloud Java Client -- Core
+
+This module provides common functionality required by service-specific modules of this library.
+
+[![Kokoro CI][kokoro-badge]][kokoro-badge-link]
+[](https://img.shields.io/maven-central/v/com.google.cloud/google-cloud-core.svg)
+
+- [API Documentation][api-docs]
+
+## Quickstart
+
+[//]: # ({x-version-update-start:google-cloud-core:released})
+If you are using Maven, add this to your pom.xml file
+```xml
+<dependency>
+ <groupId>com.google.cloud</groupId>
+ <artifactId>google-cloud-core</artifactId>
+ <version>1.84.0</version>
+</dependency>
+```
+If you are using Gradle, add this to your dependencies
+```Groovy
+compile 'com.google.cloud:google-cloud-core:1.84.0'
+```
+If you are using SBT, add this to your dependencies
+```Scala
+libraryDependencies += "com.google.cloud" % "google-cloud-core" % "1.84.0"
+```
+[//]: # ({x-version-update-end})
+
+## Java Versions
+
+Java 7 or above is required for using this client.
+
+## Contributing
+
+Contributions to this library are always welcome and highly encouraged.
+
+See [CONTRIBUTING][contributing] documentation for more information on how to get started.
+
+Please note that this project is released with a Contributor Code of Conduct. By participating in
+this project you agree to abide by its terms. See [Code of Conduct][code-of-conduct] for more
+information.
+
+## Versioning
+
+This library follows [Semantic Versioning][semver].
+
+It is currently in major version one (``1.y.z``), which means that the public API should be
+considered stable.
+
+## License
+
+Apache 2.0 - See [LICENSE][license] for more information.
+
+[contributing]: https://github.com/googleapis/java-core/blob/master/CONTRIBUTING.md
+[code-of-conduct]: https://github.com/googleapis/java-core/blob/master/CODE_OF_CONDUCT.md
+[license]: https://github.com/googleapis/java-core/blob/master/LICENSE
+[semver]: http://semver.org/
+[cloud-platform]: https://cloud.google.com/
+[kokoro-badge]: http://storage.googleapis.com/cloud-devrel-public/java/badges/java-core/master.svg
+[kokoro-badge-link]: (http://storage.googleapis.com/cloud-devrel-public/java/badges/java-core/master.html)
+[api-docs]: https://googleapis.dev/java/google-cloud-core/latest
