diff --git a/README.md b/README.md
index 55f354f..ec7c904 100644
--- a/README.md
+++ b/README.md
@@ -1,7 +1,93 @@
 # shareon
 
-I'm not shareon maintainer.
+<img src="https://raw.githubusercontent.com/googlefonts/noto-emoji/master/png/128/emoji_u1f4ef.png" align="right" alt="Postal Horn emoji" width="96" height="96">
 
-I just publish a specific version waiting my pull request will be merged.
+Lightweight, stylish and ethical share buttons.
 
-Check [original repository](https://github.com/NickKaramoff/shareon).
\ No newline at end of file
+- **Small.** Dependency-free. CSS+JS bundle is only 6 KB minified and gzipped.
+- **Stylish.** Uses official vector logos and colors with no visual mess.
+- **Ethical.** Embeds no tracking code. JS is required only for the setup.
+
+<img src="https://raw.githubusercontent.com/NickKaramoff/shareon/master/docs/screen01@2x.png" height="156" width="416" alt="shareon example">
+
+----
+Observe the live demo here: [shareon.js.org](https://shareon.js.org)
+
+## Install
+
+Include the link to shareon's JS and CSS in your website:
+
+```html
+<link href="https://cdn.jsdelivr.net/npm/shareon@1.2.0/dist/shareon.min.css" rel="stylesheet">
+<script src="https://cdn.jsdelivr.net/npm/shareon@1.2.0/dist/shareon.min.js" type="text/javascript"></script>
+```
+
+or install it via NPM use it in a JS file that you will bundle:
+
+```sh
+npm install shareon
+# or
+yarn add shareon
+```
+
+```js
+require('shareon');
+```
+
+## Usage
+
+> shareon was heavily inspired by [Likely](https://ilyabirman.net/projects/likely/),
+  and has a backwards-compatible API (excluding themes and sizes).
+
+Create a container with class `shareon` and populate it with elements, whose
+classes match the names of social networks:
+
+```html
+<div class="shareon">
+    <a class="facebook"></a>
+    <a class="linkedin"></a>
+    <a class="messenger"></a>
+    <a class="odnoklassniki"></a>
+    <a class="pinterest"></a>
+    <a class="pocket"></a>
+    <button class="reddit"></button>
+    <button class="telegram"></button>
+    <button class="twitter"></button>
+    <button class="viber"></button>
+    <button class="vkontakte"></button>
+    <button class="whatsapp"></button>
+</div>
+```
+
+If you use `<a>`, the buttons will get a `href`-attribute to them. In other cases
+they will get a listener on `click` event, so you can use `<button>`s if you wish.
+
+By default, the URL and the title of the page will be used in sharing dialogs.
+To change this, you can use the `data-url` and `data-title` attributes. Use them
+on the whole container or on the specific buttons:
+
+```html
+<div class="shareon" data-url="https://example.com">
+    <a class="facebook" data-title="Custom Facebook title"></a>
+    <a class="twitter" data-title="Custom Twitter title"></a>
+</div>
+```
+
+Apart from the URL and title, some networks support extra parameters:
+
+- add `data-media` to an Odnoklassniki, Pinterest, or VK button to customize the pinned picture
+- add `data-text` to a WhatsApp, Telegram or Viber button to add custom message text
+- add `data-via` to a Twitter button to mention a user
+
+Here are all the custom parameters in their glory:
+
+```html
+<div class="shareon" data-url="https://example.com/custom-url">
+    <a class="facebook" data-title="Custom Facebook title"></a>
+    <a class="messenger" data-url="https://my-cool-website.com"></a>
+    <a class="pinterest" data-media="https://picsum.photos/500">Pin</a>
+    <a class="telegram" data-text="Check this out!"></a>
+    <a class="twitter" data-via="MyNickname"></a>
+    <a class="whatsapp">Send</a>
+</div>
+```
diff --git a/package.json b/package.json
index 21985be..c6006af 100644
--- a/package.json
+++ b/package.json
@@ -1,6 +1,6 @@
 {
-  "name": "@amiceli/shareon",
-  "version": "1.2.1",
+  "name": "shareon",
+  "version": "1.2.0",
   "description": "Lightweight, stylish and ethical share buttons for popular social networks",
   "license": "MIT",
   "homepage": "https://shareon.js.org",
@@ -11,10 +11,10 @@
   ],
   "repository": {
     "type": "git",
-    "url": "git+https://github.com/amiceli/shareon.git"
+    "url": "git+https://github.com/NickKaramoff/shareon.git"
   },
   "bugs": {
-    "url": "https://github.com/amiceli/shareon"
+    "url": "https://github.com/NickKaramoff/shareon/issues"
   },
   "author": {
     "name": "Nikita Karamov",
diff --git a/rollup.config.js b/rollup.config.js
index 07c579e..3905827 100644
--- a/rollup.config.js
+++ b/rollup.config.js
@@ -13,7 +13,7 @@ const pkg = require('./package.json');
 const inputFile = './src/index.ts';
 const outputDir = isDev ? './dev/' : './dist/';
 
-const bannerText = `${pkg.name.replace('/', '').replace('@', '')} v${pkg.version} by Nikita Karamov\n${pkg.homepage}`;
+const bannerText = `${pkg.name} v${pkg.version} by Nikita Karamov\n${pkg.homepage}`;
 
 /*
  * PLUGINS
@@ -40,7 +40,7 @@ if (!isDev) {
 }
 
 plugins.push(postcss({
-  extract: `${pkg.name.replace('/', '').replace('@', '')}.min.css`,
+  extract: `${pkg.name}.min.css`,
   plugins: [
     (!isDev) && postcssPluginCssnano({
       preset: 'default',
@@ -60,25 +60,25 @@ const output = [];
 
 if (isDev) {
   output.push({
-    name: pkg.name.replace('/', '').replace('@', ''),
+    name: pkg.name,
     format: 'iife',
-    file: `${outputDir}${pkg.name.replace('/', '').replace('@', '')}.js`,
+    file: `${outputDir}${pkg.name}.js`,
   });
 } else {
   output.push({
-    name: pkg.name.replace('/', '').replace('@', ''),
+    name: pkg.name,
     format: 'cjs',
-    file: `${outputDir}${pkg.name.replace('/', '').replace('@', '')}.cjs`,
+    file: `${outputDir}${pkg.name}.cjs`,
   });
   output.push({
-    name: pkg.name.replace('/', '').replace('@', ''),
+    name: pkg.name,
     format: 'esm',
-    file: `${outputDir}${pkg.name.replace('/', '').replace('@', '')}.mjs`,
+    file: `${outputDir}${pkg.name}.mjs`,
   });
   output.push({
-    name: pkg.name.replace('/', '').replace('@', ''),
+    name: pkg.name,
     format: 'iife',
-    file: `${outputDir}${pkg.name.replace('/', '').replace('@', '')}.min.js`,
+    file: `${outputDir}${pkg.name}.min.js`,
     plugins: [terser({ output: { comments: false } })],
   });
 }