Skip to content

Commit b00ec5f

Browse files
readme + ci/cd added
1 parent 447615e commit b00ec5f

File tree

5 files changed

+110
-46
lines changed

5 files changed

+110
-46
lines changed

.env.example

Lines changed: 4 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,6 @@
11
VITE_APP_MODULE_NAME=first_contract
22
VITE_APP_NETWORK=testnet
3-
VITE_APP_MODULE_ADDRESS=0x9e0fa0199574b8e233b5e00b2625f55f2490264452d9e
4-
VITE_APP_PINATA_API_KEY=490fe61c
5-
VITE_APP_PINATA_SECRET_API_KEY=484cd6f5127e1ef963b691207df29
3+
VITE_APP_MODULE_ADDRESS=your_smart_contract_address_here
4+
VITE_APP_PINATA_API_KEY=your_pinata_api_key_here
5+
VITE_APP_PINATA_SECRET_API_KEY=your_pinata_secret_api_key_here
6+
VITE_GEMINI_API_KEY=your_gemini_api_key_here

.github/workflows/ci.yml

Lines changed: 34 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,34 @@
1+
name: CI/CD
2+
3+
on:
4+
push:
5+
branches: [ main ]
6+
pull_request:
7+
branches: [ main ]
8+
9+
jobs:
10+
build:
11+
runs-on: ubuntu-latest
12+
13+
steps:
14+
- uses: actions/checkout@v3
15+
16+
- name: Setup Node.js
17+
uses: actions/setup-node@v3
18+
with:
19+
node-version: '18'
20+
cache: 'npm'
21+
22+
- name: Install dependencies
23+
run: npm ci
24+
25+
- name: TypeScript check
26+
run: npx tsc --noEmit
27+
28+
- name: Run ESLint
29+
run: npm run lint
30+
31+
- name: Build
32+
run: npm run build
33+
34+

README.md

Lines changed: 72 additions & 43 deletions
Original file line numberDiff line numberDiff line change
@@ -2,30 +2,65 @@
22

33
Welcome to Sault, your trusted document management solution that leverages blockchain technology for secure, transparent, and efficient document handling.
44

5-
65
<img src="./public/logo.png" alt="Sault Logo" width="100" />
76

7+
---
8+
9+
## 🔍 Problem → Cause → Solution Journey
10+
11+
### 🔴 Problem
12+
13+
- Organizations face **difficulty managing important documents**.
14+
- Traditional methods are often **scattered, unsecure**, and **lack categorization**.
15+
- It becomes **time-consuming** to locate, verify, and organize files.
16+
- There's a **risk of data loss, fraud**, or unauthorized access.
17+
- Lack of Trust in Bussiness contract
18+
19+
### 🔠 Causes
20+
21+
- Paper or traditional digital systems are **decentralized and disorganized**.
22+
- **Lack of encryption** and verification mechanisms.
23+
- **No single secure repository** for all types of documents.
24+
- Difficulty in **detecting duplicate or tampered files**.
25+
26+
### 🟢 Solution – SAULT
27+
28+
- **Secure Vault**: All your documents are safely stored with blockchain immutability.
29+
- **Robust Contract**: There is share in which two or more parties can sign a contract and verify while making a legal deals, decision etc.
30+
- **AI-powered Categorization**: Easily organize and retrieve files with intelligent tagging.
31+
- **Fraud Detection**: Detect duplicates, tampered files, and fraudulent documents.
32+
- **Legal and Transparent**: Every transaction and update is securely logged.
33+
- **Chatbot Interface**: Easily query and interact with documents.
34+
- **Blockchain + AI Combo**: Offers security, auditability, and convenience in one place.
35+
36+
---
37+
838
## 🌟 Features
939

10-
- 📑 **Secure Document Storage**: Store your documents with blockchain-backed security
40+
- 📁 **Secure Document Storage**: Store your documents with blockchain-backed security
1141
- ✍️ **Document Signing**: Digital signature capabilities for legal documents
12-
- 🏷️ **Smart Categorization**: Organize documents with intelligent categorization
42+
- 🏼 **Smart Categorization**: Organize documents with intelligent categorization
1343
- 📊 **Analytics Dashboard**: Track and analyze document metrics
1444
- 🔒 **Wallet Integration**: Seamless connection with Aptos blockchain wallets
1545
-**Fast Retrieval**: Quick access to your stored documents
1646
- 📱 **Responsive Design**: Works perfectly on both desktop and mobile devices
1747

48+
---
49+
1850
## 🛠️ Technology Stack
1951

20-
- **Frontend**: React 18 with TypeScript
52+
- **Frontend** : React 18 with TypeScript
2153
- **Build Tool**: Vite
22-
- **Styling**: Tailwind CSS
54+
- **Styling** : Tailwind CSS
2355
- **Components**: Radix UI
2456
- **Blockchain**: Aptos Network
25-
- **Charts**: Chart.js & Recharts
26-
- **Routing**: React Router DOM
57+
- **Wallet** : Petra
58+
- **Charts** : Chart.js & Recharts
59+
- **Routing** : React Router DOM
2760
- **State Management**: React Context
2861

62+
---
63+
2964
## 🚀 Getting Started
3065

3166
### Prerequisites
@@ -36,54 +71,30 @@ Welcome to Sault, your trusted document management solution that leverages block
3671

3772
### Installation
3873

39-
1. Clone the repository:
4074
```bash
41-
git clone <repository-url>
75+
git clone https://github.com/ashwinkothavade/HackByte3.0
4276
cd sault
43-
```
44-
45-
2. Install dependencies:
46-
```bash
4777
npm install
48-
```
49-
50-
3. Set up environment variables:
51-
```bash
5278
cp .env.example .env
53-
```
54-
Fill in the required environment variables in the `.env` file.
55-
56-
### Development
57-
58-
Start the development server:
59-
```bash
79+
# Fill in required variables
6080
npm run dev
6181
```
62-
The application will be available at `http://localhost:5173`
6382

64-
### Building for Production
65-
66-
Build the project:
67-
```bash
68-
npm run build
69-
```
83+
Visit `http://localhost:5173` to start using the app.
7084

71-
Preview the production build:
72-
```bash
73-
npm run preview
74-
```
85+
---
7586

7687
## 📦 Project Structure
7788

7889
```
7990
sault/
80-
── blockchain_0/ # Aptos smart contract code
81-
── frontend/
82-
── components/ # React components
83-
── utils/ # Utility functions
84-
── lib/ # Shared libraries
85-
── public/ # Static assets
86-
── scripts/ # Build and deployment scripts
91+
🔽️── blockchain_0/ # Aptos smart contract code
92+
🔽️── frontend/
93+
🔽️── components/ # React components
94+
🔽️── utils/ # Utility functions
95+
🔽️── lib/ # Shared libraries
96+
🔽️── public/ # Static assets
97+
🔽️── scripts/ # Build and deployment scripts
8798
```
8899

89100
## 💻 Available Scripts
@@ -99,6 +110,20 @@ sault/
99110
- `npm run move:compile`: Compile Move modules
100111
- `npm run move:publish`: Publish Move modules
101112

113+
---
114+
115+
## 📊 Workflow
116+
117+
<img src="./public/workflow.jpg" alt="workflow" />
118+
119+
---
120+
121+
## 👥 Contributors
122+
123+
<img src="./public/contri.jpg" alt="contri " width="500" />
124+
125+
---
126+
102127
## 🤝 Contributing
103128

104129
1. Fork the repository
@@ -107,10 +132,14 @@ sault/
107132
4. Push to the branch (`git push origin feature/amazing-feature`)
108133
5. Open a Pull Request
109134

135+
---
136+
110137
## 📄 License
111138

112139
This project is licensed under the Apache-2.0 License - see the [LICENSE](LICENSE) file for details.
113140

141+
---
142+
114143
## 🔗 Links
115144

116145
- [Documentation](#)
@@ -119,4 +148,4 @@ This project is licensed under the Apache-2.0 License - see the [LICENSE](LICENS
119148

120149
---
121150

122-
Made with ❤️ by the Sault Team
151+
Made with ❤️ by the Sault Team

public/contri.jpg

414 KB
Loading

public/workflow.jpg

54.4 KB
Loading

0 commit comments

Comments
 (0)