diff --git a/README.md b/README.md
new file mode 100644
index 0000000..a99c65b
--- /dev/null
+++ b/README.md
@@ -0,0 +1,52 @@
+# Porkbun API bash client
+
+> The client under development, more features will be added with the time.
+
+Porkbun v3 API client in bash. The script needs the following packages to be installed in the system:
+
+- curl: to perform the HTTPS requests.
+- jq: to parse and beautify the JSON responses.
+
+## Supported API endpoints
+
+The following API endpoints are the ones that will be supported, the currently implemented ones are marked with a check:
+
+- General
+  - [x] [Authentication (Ping)](https://porkbun.com/api/json/v3/documentation#Authentication)
+  - [x] [Authentication (Ping ipv4)](https://porkbun.com/api/json/v3/documentation#ipv4)
+- Domain
+  - [ ] [Domain Update Name Servers](https://porkbun.com/api/json/v3/documentation#Domain%20Update%20Name%20Servers)
+  - [ ] [Domain Get Name Servers](https://porkbun.com/api/json/v3/documentation#Domain%20Get%20Name%20Servers)
+  - [ ] [Domain List All](https://porkbun.com/api/json/v3/documentation#Domain%20List%20All)
+  - [ ] [Domain Add Url Forward](https://porkbun.com/api/json/v3/documentation#Domain%20Add%20URL%20Forward)
+  - [ ] [Domain Get URL Forwarding](https://porkbun.com/api/json/v3/documentation#Domain%20Get%20URL%20Forwarding)
+  - [ ] [Domain Delete Url Forward](https://porkbun.com/api/json/v3/documentation#Domain%20Delete%20URL%20Forward)
+- DNS
+  - [x] [DNS Create Record](https://porkbun.com/api/json/v3/documentation#DNS%20Create%20Record)
+  - [ ] [DNS Edit Record by Domain and ID](https://porkbun.com/api/json/v3/documentation#DNS%20Edit%20Record%20by%20Domain%20and%20ID)
+  - [ ] [DNS Edit Records by Domain, Subdomain and Type](https://porkbun.com/api/json/v3/documentation#DNS%20Edit%20Record%20by%20Domain,%20Subdomain%20and%20Type)
+  - [x] [DNS Delete Record by Domain and ID](https://porkbun.com/api/json/v3/documentation#DNS%20Delete%20Record%20by%20Domain%20and%20ID)
+  - [ ] [DNS Delete Records by Domain, Subdomain and Type](https://porkbun.com/api/json/v3/documentation#DNS%20Delete%20Records%20by%20Domain,%20Subdomain%20and%20Type)
+  - [ ] [DNS Retrieve Records by Domain or ID](https://porkbun.com/api/json/v3/documentation#DNS%20Retrieve%20Records%20by%20Domain%20or%20ID)
+  - [ ] [DNS Retrieve Records by Domain, Subdomain and Type](https://porkbun.com/api/json/v3/documentation#DNS%20Retrieve%20Records%20by%20Domain,%20Subdomain%20and%20Type)
+
+## Usage
+
+1. Create API keys for your account, on [Account > API Access](https://porkbun.com/account/api)
+2. Enable "API Access" on the domains, press on "Details" and check the "API Access" settings on the desires domains.
+3. Execute the script, it will prompt for your API credentials the first time you launch it. The configuration file is saved on the same location as is the script.
+
+   > The generated file is in plain text, with 600 (rw-------) permission.
+
+4. Run again the script, a help page will be shown when encountering invalid parameters. Such as
+
+   ```
+   Usage: ./porkbun-linux-cli <command>
+
+   Commands:
+     ping  Test communication with the API, also returns the IP address.
+     ping-ipv4  Test communication with the API, also returns the IP address in IPv4 format.
+     dns  Manage DNS records
+
+   Version: v0.1.0
+   ```