From 9f5b04df17e52186ec3104889a5c45edb99eac46 Mon Sep 17 00:00:00 2001
From: matstyler <mat.franczuk@gmail.com>
Date: Sat, 7 Dec 2024 13:47:18 +0100
Subject: [PATCH 1/2] chore: Contribution guideline

---
 README.md                  |  5 +++
 docs/.vitepress/sidebar.ts |  4 +++
 docs/CONTRIBUTING.md       |  1 +
 docs/docs/contribution.md  | 73 ++++++++++++++++++++++++++++++++++++++
 4 files changed, 83 insertions(+)
 create mode 100644 docs/CONTRIBUTING.md
 create mode 100644 docs/docs/contribution.md

diff --git a/README.md b/README.md
index 568ca0bda..f5ba731cd 100644
--- a/README.md
+++ b/README.md
@@ -51,5 +51,10 @@ For comprehensive guides, API references, and examples, refer to our [official d
 
 Join our vibrant community for support, discussions, and updates:
 
+
+## How to Contribute
+
+We welcome contributions from the community! Please refer to our [contributing guidelines](https://docs.synpress.io/docs/contribution).
+
 - [Discord](https://discord.gg/XhZKSRGtWc)
 - [X (formerly Twitter)](https://twitter.com/Synpress_)
diff --git a/docs/.vitepress/sidebar.ts b/docs/.vitepress/sidebar.ts
index 329f62f67..52274c2c0 100644
--- a/docs/.vitepress/sidebar.ts
+++ b/docs/.vitepress/sidebar.ts
@@ -31,6 +31,10 @@ export const sidebar: DefaultTheme.Sidebar = {
         { text: 'Built-in Fixtures', link: '/docs/guides/fixtures' },
         { text: 'CI', link: '/docs/guides/ci' }
       ]
+    },
+    {
+      text: 'Contribution',
+      items: [{ text: 'Contribution Guide', link: '/docs/contribution' }]
     }
   ],
   '/api/': TypedocSidebar
diff --git a/docs/CONTRIBUTING.md b/docs/CONTRIBUTING.md
new file mode 100644
index 000000000..0519ecba6
--- /dev/null
+++ b/docs/CONTRIBUTING.md
@@ -0,0 +1 @@
+ 
\ No newline at end of file
diff --git a/docs/docs/contribution.md b/docs/docs/contribution.md
new file mode 100644
index 000000000..4cae42d14
--- /dev/null
+++ b/docs/docs/contribution.md
@@ -0,0 +1,73 @@
+# Contributing to Synpress
+
+This guide will help you set up Synpress for local development.
+
+## Prerequisites
+
+Before you begin, ensure you have:
+- Node.js (v20 or higher)
+- pnpm (v9 or higher)
+- Git
+
+## First Setup
+
+1. Clone the repository:
+   ```bash
+   git clone https://github.com/Synthetixio/synpress.git
+   cd synpress
+   ```
+
+2. Install dependencies:
+   ```bash
+   pnpm install
+   ```
+
+3. Build the project:
+   ```bash
+   pnpm build
+   ```
+
+## Development Workflow
+
+1. Create a new branch for your changes:
+   ```bash
+   git checkout -b feature/your-feature-name
+   ```
+
+2. Make your changes and add tests (e2e and unit tests if needed):
+   ```bash
+   pnpm test
+   ```
+
+3. Format and lint your code:
+   ```bash
+   pnpm lint
+   ```
+
+4. Commit your changes using [gitmoji](https://gitmoji.dev/) convention:
+   ```bash
+   git add .
+   git commit -m "✨ feat: Add new feature"
+   ```
+
+5. Push your changes and create a pull request:
+   ```bash
+   git push origin feature/your-feature-name
+   ```
+
+## Project Structure
+
+- `release/` - Main Synpress package
+- `packages/` - Core packages
+  - `cache/` - Browser state caching functionality
+  - `core/` - Core functionality
+  - `tsconfig/` - Shared TypeScript configuration
+- `wallets/` - Wallet integrations
+  - `metamask/` - MetaMask integration
+  - `ethereum-wallet-mock/` - Ethereum Wallet Mock integration
+- `docs/` - Documentation website
+- `examples/` - Example projects
+
+## Need Help?
+
+Join our [Discord](https://discord.gg/XhZKSRGtWc) community for support and discussions.

From 3d7565f6796132aae3147283ee9a016db5862339 Mon Sep 17 00:00:00 2001
From: styler <63294765+matstyler@users.noreply.github.com>
Date: Sat, 7 Dec 2024 13:48:32 +0100
Subject: [PATCH 2/2] Delete docs/CONTRIBUTING.md

---
 docs/CONTRIBUTING.md | 1 -
 1 file changed, 1 deletion(-)
 delete mode 100644 docs/CONTRIBUTING.md

diff --git a/docs/CONTRIBUTING.md b/docs/CONTRIBUTING.md
deleted file mode 100644
index 0519ecba6..000000000
--- a/docs/CONTRIBUTING.md
+++ /dev/null
@@ -1 +0,0 @@
- 
\ No newline at end of file