Skip to content

Commit 581224f

Browse files
ICodingStackICodingStack
committed
full project
0 parents  commit 581224f

11 files changed

Lines changed: 4161 additions & 0 deletions

‎.gitignore‎

Lines changed: 43 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,43 @@
1+
# Dependencies
2+
node_modules/
3+
.pnp
4+
.pnp.js
5+
6+
# Build outputs
7+
dist/
8+
build/
9+
.output/
10+
11+
# Environment files
12+
.env
13+
.env.local
14+
.env.*.local
15+
16+
# Editor directories and files
17+
.idea/
18+
.vscode/
19+
*.suo
20+
*.ntvs*
21+
*.njsproj
22+
*.sln
23+
*.sw?
24+
.DS_Store
25+
Thumbs.db
26+
27+
# Logs
28+
logs/
29+
*.log
30+
npm-debug.log*
31+
yarn-debug.log*
32+
yarn-error.log*
33+
34+
# OS files
35+
.DS_Store
36+
.DS_Store?
37+
._*
38+
.Spotlight-V100
39+
.Trashes
40+
ehthumbs.db
41+
42+
# Optional: local serve config
43+
.serve/

‎LICENSE‎

Lines changed: 21 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,21 @@
1+
MIT License
2+
3+
Copyright (c) 2025 EmailForge Contributors
4+
5+
Permission is hereby granted, free of charge, to any person obtaining a copy
6+
of this software and associated documentation files (the "Software"), to deal
7+
in the Software without restriction, including without limitation the rights
8+
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
9+
copies of the Software, and to permit persons to whom the Software is
10+
furnished to do so, subject to the following conditions:
11+
12+
The above copyright notice and this permission notice shall be included in all
13+
copies or substantial portions of the Software.
14+
15+
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
16+
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
17+
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
18+
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
19+
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
20+
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
21+
SOFTWARE.

‎README.md‎

Lines changed: 164 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,164 @@
1+
# EmailForge ✦
2+
3+
**The Most Elegant & Intelligent HTML Email Signature Builder**
4+
5+
> Signatures That Impress — free, open source, and entirely client-side.
6+
7+
[![License: MIT](https://img.shields.io/badge/License-MIT-6366f1.svg)](LICENSE)
8+
![HTML5](https://img.shields.io/badge/HTML5-E34F26?logo=html5&logoColor=white)
9+
![TailwindCSS](https://img.shields.io/badge/TailwindCSS-06B6D4?logo=tailwindcss&logoColor=white)
10+
![Vanilla JS](https://img.shields.io/badge/JavaScript-F7DF1E?logo=javascript&logoColor=black)
11+
12+
---
13+
14+
## ✦ What is EmailForge?
15+
16+
EmailForge is a premium, browser-based email signature builder designed to rival paid tools like WiseStamp and Newoldstamp — completely free, with no account required and no data ever leaving your browser.
17+
18+
It combines a beautiful, luxurious design system with an intelligent AI-style auto-fill feature that generates a complete, polished professional signature from just three fields: **name**, **title**, and **company**.
19+
20+
---
21+
22+
## ✨ Features
23+
24+
| Feature | Description |
25+
|---|---|
26+
| **AI Signature Builder** | Enter name, title & company → get a complete signature instantly |
27+
| **6 Premium Templates** | Minimal, Executive, Modern, Creative, Corporate, Luxury |
28+
| **Live Preview** | Real-time rendering in Gmail, Outlook & Apple Mail modes |
29+
| **Custom Accent Colors** | 10 presets + custom color picker, updates entire UI instantly |
30+
| **Multiple Profiles** | Save, switch, and rename unlimited signature profiles |
31+
| **Smart Export** | Copy HTML, Gmail-optimised, Outlook-optimised, or Plain Text |
32+
| **Auto-Save** | All data persisted to `localStorage` — never lose your work |
33+
| **Dark / Light Mode** | Elegant dark mode by default with smooth toggle |
34+
| **Fully Responsive** | Mobile-first, works on any screen size |
35+
| **100% Client-Side** | No server, no account, no tracking |
36+
37+
---
38+
39+
## 🚀 Quick Start
40+
41+
1. **Clone the repo**
42+
```bash
43+
git clone https://github.com/yourusername/emailforge.git
44+
cd emailforge
45+
```
46+
47+
2. **Open in browser**
48+
```bash
49+
# No build step required — just open index.html
50+
open index.html
51+
52+
# Or serve locally for best experience:
53+
npx serve .
54+
# or
55+
python3 -m http.server 3000
56+
```
57+
58+
3. **That's it.** No npm install, no bundler, no configuration.
59+
60+
---
61+
62+
## 📁 Project Structure
63+
64+
```
65+
emailforge/
66+
├── index.html # Main application shell
67+
├── css/
68+
│ └── style.css # Premium design system (CSS variables + components)
69+
├── js/
70+
│ ├── main.js # App orchestrator & state management
71+
│ ├── signature-generator.js # 6 template renderers → inline-CSS HTML output
72+
│ ├── ai-signature-builder.js # Intelligent auto-fill from minimal input
73+
│ ├── preview-renderer.js # Live preview, client switching, color propagation
74+
│ ├── copy-utils.js # Gmail / Outlook / HTML / plain-text export
75+
│ └── utils.js # Shared helpers (debounce, storage, clipboard, etc.)
76+
├── assets/
77+
│ └── icons/ # SVG icon assets (if extended)
78+
├── README.md
79+
├── LICENSE
80+
└── .gitignore
81+
```
82+
83+
---
84+
85+
## 🎨 Templates
86+
87+
| Template | Best For |
88+
|---|---|
89+
| **Minimal** | Clean, distraction-free, suits any industry |
90+
| **Executive** | Bold left-border accent, high-authority feel |
91+
| **Modern** | Colored header banner, great for startups |
92+
| **Creative** | Full-bleed accent block, bold & expressive |
93+
| **Corporate** | Classic multi-line layout, enterprise-ready |
94+
| **Luxury** | Gold-accent borders, refined & prestigious |
95+
96+
---
97+
98+
## 🤖 AI Signature Builder
99+
100+
The AI Magic tab lets you generate a complete signature in seconds:
101+
102+
1. Enter your **Full Name**, **Job Title**, and **Company**
103+
2. Choose a **tone** (Executive, Creative, Minimal, Warm, Technical)
104+
3. Click **Generate My Signature**
105+
106+
EmailForge will intelligently:
107+
- Generate a professional email address and website URL
108+
- Create a realistic phone number placeholder
109+
- Write a tailored personal tagline
110+
- Infer social media handles
111+
- Select the best-fitting template and accent color
112+
113+
Everything is editable after generation.
114+
115+
---
116+
117+
## 📋 How to Install Your Signature
118+
119+
### Gmail
120+
1. Click **Gmail** button → copies rich HTML to clipboard
121+
2. Open Gmail → Settings (⚙) → See all settings → General → Signature
122+
3. Create new signature → Paste with `Ctrl+V` / `Cmd+V`
123+
124+
### Outlook
125+
1. Click **Outlook** button → copies Outlook-optimised HTML
126+
2. Open Outlook → File → Options → Mail → Signatures
127+
3. New → Paste the HTML
128+
129+
### Apple Mail
130+
1. Click **Copy HTML** → use the source code
131+
2. Apple Mail → Preferences → Signatures → New
132+
3. Drag the HTML file into the signature composer
133+
134+
---
135+
136+
## 🛠 Customisation
137+
138+
EmailForge uses CSS custom properties (`--accent`, `--bg`, etc.) for theming. You can extend the design by modifying `css/style.css`.
139+
140+
To add a new template, add a renderer function in `signature-generator.js` and register it in the `TEMPLATES` object and `generate()` switch statement.
141+
142+
---
143+
144+
## 🔒 Privacy
145+
146+
EmailForge stores all data locally in your browser's `localStorage`. No data is ever sent to any server. The only external requests are for Google Fonts and Tailwind CSS CDN.
147+
148+
---
149+
150+
## 📄 License
151+
152+
MIT © EmailForge Contributors — see [LICENSE](LICENSE) for details.
153+
154+
---
155+
156+
## 🙏 Built With
157+
158+
- [Tailwind CSS](https://tailwindcss.com) — utility-first CSS framework
159+
- [Google Fonts](https://fonts.google.com) — Playfair Display + DM Sans
160+
- Pure Vanilla JavaScript — no framework dependencies
161+
162+
---
163+
164+
*Made with ✦ for professionals who care about first impressions.*

0 commit comments

Comments
 (0)