diff --git a/README.md b/README.md
index 4e38306..1630e58 100644
--- a/README.md
+++ b/README.md
@@ -1,26 +1,46 @@
 # Mercury
 
-(WIP) Terminal-like blog theme built from [Astro](https://astro.build)
+Terminal-like blog theme built from [Astro](https://astro.build), still in early beta.
+
+Demo: https://icy-beach-00f5be01e.6.azurestaticapps.net/
 
 > 🧑‍🚀 **Seasoned astronaut?** Delete this file. Have fun!
 
-## 🚀 Project Structure
+## 🌌 Features
+- Minimal, terminal like
+- Ship only necessary JavaScript
+- Full text search based on `Fuse.js`
+- Full text RSS
+- Create Blogrolls via a yaml file
+- Your status at Fediverse, now at your home
+- Comments powered by multiple engines
 
-Inside of your Astro project, you'll see the following folders and files:
+## 🚀 Getting Started
+clone the repo and install dependencies:
 
-```text
-/
-├── public/
-│   └── favicon.svg
-├── src/
-│   ├── layouts/
-│   │   └── Layout.astro
-│   └── pages/
-│       └── index.astro
-└── package.json
+```bash
+git clone https://git.gb0.dev/gb/mercury.git
 ```
+```bash
+cd mercury && pnpm install
+```
+run the dev server:
 
-To learn more about the folder structure of an Astro project, refer to [our guide on project structure](https://docs.astro.build/en/basics/project-structure/).
+```bash
+pnpm run dev
+```
+open [localhost:4321](http://localhost:4321) in your browser.
+
+## 🔧 Usage
+All you need is editing the `astro.config.mjs`'s site & base.
+
+For further config, edit `src/config.ts` according to the comment.
+
+To start writing, put your markdown & mdx files to /src/content/posts folder.
+
+To create a page, put markdown files into /src/content/pages folder.
+
+Shortcode-like components is also available at /src/components/shortcodes folder.
 
 ## 🧞 Commands
 
@@ -37,4 +57,7 @@ All commands are run from the root of the project, from a terminal:
 
 ## 👀 Want to learn more?
 
-Feel free to check [our documentation](https://docs.astro.build) or jump into our [Discord server](https://astro.build/chat).
+See the post [🕊](). I hope you like it. 💜
+
+## ⚖️ License
+GNU Affero Public License 3.0
\ No newline at end of file
diff --git a/src/components/shortcodes/Spoiler.astro b/src/components/shortcodes/Spoiler.astro
index 7a7dcff..319f3f6 100644
--- a/src/components/shortcodes/Spoiler.astro
+++ b/src/components/shortcodes/Spoiler.astro
@@ -1,11 +1,21 @@
 ---
 const { tip = '' } = Astro.props
 ---
-{/* TODO: make it work in paragraph wrapped elements */}
 <span class="spoiler" title={tip}>
     <slot/>
 </span>
 <style>
+    :global(.spoiler p) {
+        background-color: #252525;
+        color: #252525;
+        transition: color 0.5s;
+        width: fit-content;
+    }
+
+    :global(.spoiler:hover p) {
+        color: #ffffff;
+    }
+
     .spoiler {
         background-color: #252525;
         color: #252525;
diff --git a/src/content/pages/test.mdx b/src/content/pages/test.mdx
index fd9f7a8..85a55f9 100644
--- a/src/content/pages/test.mdx
+++ b/src/content/pages/test.mdx
@@ -14,4 +14,9 @@ testestestest
     ~~This is the content of the spoiler.~~
 </Spoiler>
 
+<Spoiler tip="Spoiler Title">
+    ~~This is the content of another spoiler.~~
+</Spoiler>
+
+
 <FediStatuses instanceDomain='portal.gb0.dev' userId='me' />
\ No newline at end of file