Digital Ally

Digital Ally (formerly BizBoost) is an advanced AI-powered platform designed to instantly generate professional websites, business newsletters, and analytical dashboards. Built with React, TypeScript, and powered by Google's Gemini 2.5 Flash model, it bridges the gap between business ideas and digital presence.

🚀 Features

• AI Website Generation: Transform text descriptions into fully responsive, modern landing pages using Tailwind CSS.
• Dynamic Content Creation: Automatically generates business newsletters and marketing copy customized for your brand.
• Smart Dashboard & Analytics: Get AI-driven insights and translations for business performance metrics.
• Voice Interaction:
  • Speech-to-Text: Dictate your website requirements and prompts.
  • Text-to-Speech: Listen to generated content and insights.
• Customization: Choose from curated color palettes and modify generated designs with follow-up prompts.
• Multi-Language Support: Interactive interface supporting multiple languages.
• Live Preview & Code Export: View changes in real-time and export clean, deployment-ready HTML/CSS code.
• Privacy Controls: Versioned consent before remote AI processing, local-only generation, and one-click data deletion.

🛠️ Tech Stack

• Frontend Framework: React 19
• Build Tool: Vite
• Language: TypeScript
• Styling: Tailwind CSS
• AI Model: Google Gemini 2.5 Flash via @google/genai SDK
• Environment: Node.js

📦 Installation

Clone the Repository

git clone <repository-url>
cd digital-ally

Install Dependencies

npm install

Configure Environment Variables

Copy the example file:

cp .env.example .env

Update the values:

GEMINI_API_KEY=your_gemini_api_key
GEMINI_MODEL=gemini-2.5-flash
SERVER_CLIENT_TOKEN=replace_with_secure_random_token
AI_CONSENT_VERSION=2026-06-21

# Optional Redis Configuration
REDIS_HOST=localhost
REDIS_PORT=6379

# Optional Server Configuration
PORT=5174
DAILY_QUOTA=100
MONTHLY_QUOTA=1000

---

Running the Application

Start Frontend

npm run dev

Default Vite URL:

http://localhost:5173

Start Backend

npm run start:server

Default API URL:

http://localhost:5174

📜 Available Scripts

Script	Description
npm run dev	Start Vite development server
npm run build	Validate translations and create production build
npm run check:translations	Verify translation coverage
npm run lint:structure	Verify the expected folder layout and file locations
npm run lint:architecture	Alias for the structure and naming check
npm run preview	Preview production build locally
npm run start:server	Start Express AI proxy server

🛡️ Privacy

No business details or generated content are persisted by Digital Ally. Users must choose remote AI processing or local-only templates before using generation features. See PRIVACY.md for the data-flow, retention, deletion, logging, and deployment policy.

📂 Project Structure

digital-ally/
│
├── public/
│   └── privacy.html
│
├── scripts/
│   └── check-translations.mjs
│
├── server/
│   ├── index.js
│   └── ...
│
├── src/
│   ├── app/
│   │   ├── App.tsx
│   │   ├── context/
│   │   │   └── AppContext.tsx
│   │   └── styles.css
│   ├── components/
│   │   └── IconSet.tsx
│   ├── hooks/
│   ├── pages/
│   ├── features/
│   │   └── generation/
│   │       └── geminiService.ts
│   └── shared/
│       ├── constants.ts
│       ├── privacy.ts
│       └── types.ts
│
├── .env.example
├── package.json
├── vite.config.ts
├── tsconfig.json
├── README.md
└── src/main.tsx

🧩 Architectural diagram

🔀 Data flow diagram

💡 Usage

1. Enter Business Details: Provide your name, business name, and contact info.
2. Describe Your Vision: Use the text area or microphone to describe the website you want (e.g., "A modern coffee shop website with a menu section").
3. Select Style: Choose a color palette that fits your brand identity.
4. Generate: Click "Generate Website" to watch the AI build your site in seconds.
5. Refine: Use the modification prompt to ask for changes (e.g., "Make the hero section darker").

---

🐛 Troubleshooting

Missing GEMINI_API_KEY

Error:

GEMINI_API_KEY not set in server environment

Solution:

• Verify .env exists.
• Verify GEMINI_API_KEY is populated.
• Restart the server.

---

Redis Connection Errors

Error:

Redis connection error

Solution:

• Start Redis locally.
• Verify REDIS_HOST and REDIS_PORT.
• The application will continue running with reduced quota functionality.

---

Build Failures

Run:

npm run check:translations

Fix missing translation keys before rebuilding.

---

Port Already In Use

Change:

PORT=5174

or stop the process using the port.

---

🚧 Known Limitations

• Requires a valid Gemini API key.
• Voice features depend on browser support.
• Generated content quality depends on prompt quality.
• Redis quota tracking is unavailable when Redis is offline.
• AI features require internet connectivity.
• Browser speech APIs may behave differently across platforms.

---

🤝 Contributing

We welcome ELUSOC contributors. Please read the contribution guide before opening issues or pull requests:

• CONTRIBUTING.md

🔐 Security

Please review the security policy for reporting vulnerabilities:

• SECURITY.md

📄 License

This project is licensed under the MIT License.

Organization Notes

• src/app contains the application shell and context providers.
• src/features contains feature-specific services and workflows.
• src/shared contains cross-cutting constants, types, and privacy helpers.
• React components use PascalCase.
• Shared utilities and services use camelCase.
• Shared barrel modules may use descriptive names like IconSet.tsx when they re-export a group of helpers.
• The Vite entrypoint is src/main.tsx.
• The @/ alias points at src/ for cleaner imports.