Smack.sh — The best AI app builder 🚀

⚠️ This platform is no longer maintained because of unstable erors cuasing this platform to be completely unusable we are working on new project.

Smack.sh is an early-stage, developer-focused AI agent platform and app builder. It provides web and desktop experiences, multi-provider AI integrations, and an extensible plugin system — all built with TypeScript, Remix, and Electron for fast prototyping and production-ready workflows.

This README is optimized for discoverability using keywords like "AI agent platform", "AI app builder", "Remix Electron TypeScript", and "developer AI tooling".

---

Table of Contents

• Quick Start ✅
• Features (current) ✨
• Planned & In-Progress Features 🔁
• Why Smack.sh? 🔍
• Prerequisites
• Installation
• Development
  • Web (Remix)
  • Electron (Desktop)
• Production build
• Docker deployment
• Project structure
• Contributing 🤝
• Contact / Support 💬
• License & Acknowledgements
• Call to Action 🚩

---

Quick Start — Try Smack.sh in ~60s ⚡

1. Clone, install, and start the Remix dev server:

git clone https://github.com/smack-sh/smack-sh.git
cd smack-sh
pnpm install        # or npm install / yarn
cp .env.example .env.local
# edit .env.local for any required keys
pnpm run dev        # run the app (web + integrated services)

1. Run Electron (desktop) in parallel (recommended during development):

pnpm run electron:dev

1. Build & package for production:

pnpm run build
pnpm run package:electron

1. Quick Docker (example):

# Example build
pnpm run dockerbuild

# Example run
pnpm run dockerrun

Tip: If you prefer a one-liner to start the web dev server:

pnpm install && pnpm run dev

---

Features (current) ✨

Below are the features included in the current codebase. All items from the original README are retained and presented by category.

🤖 AI Capabilities

• Multi-provider AI integration (OpenAI, Google AI, and more)
• Support for multiple AI models (GPT-4, Claude, and others)
• Custom AI model fine-tuning support
• Batch processing for bulk operations
• AI-powered code completion and suggestions
• Natural language processing for commands
• Sentiment analysis integration
• Multi-language support for AI interactions

🖥️ Cross-Platform Experience

• Native desktop applications for Windows, macOS, and Linux
• Responsive web interface for any device
• Progressive Web App (PWA) support
• System tray integration (desktop app)
• Global hotkey support
• Dark/Light theme support
• Customizable keyboard shortcuts
• High-DPI display support

🔒 Security & Privacy

• End-to-end encryption for all communications
• Local data storage option
• Secure authentication (OAuth, API keys)
• Session management and timeout controls
• Audit logging for all operations
• GDPR compliance tools
• Data export/import functionality
• Role-based access control

🛠️ Development Tools

• Comprehensive API documentation
• Webhook support for integrations
• Plugin system for extending functionality
• Developer sandbox environment
• API key management
• WebSocket support for real-time updates
• WebAssembly modules for performance
• Custom script execution

📊 Data & Analytics

• Usage statistics and analytics
• Performance monitoring
• Error tracking and reporting
• Custom report generation
• Data visualization tools
• Export to multiple formats (JSON, CSV, PDF)
• Scheduled report generation
• API usage analytics

🔄 Workflow Automation

• Custom workflow creation
• Scheduled tasks and automation
• Conditional logic for workflows
• Integration with popular tools
• Webhook triggers
• Task queuing system
• Background processing
• Multi-step automation

🔌 Integrations

• GitHub/GitLab integration
• Slack/Discord notifications
• Email integration
• Cloud storage (Google Drive, Dropbox, etc.)
• Database connections
• CI/CD pipeline integration
• Calendar and scheduling
• Payment gateway support

📱 Mobile Experience

• Mobile-optimized web interface
• PWA installation support
• Push notifications
• Offline mode
• Camera / QR code scanning
• Biometric authentication
• Location services
• Background sync

🎨 Customization

• Custom themes and styling
• UI layout customization
• Custom keyboard shortcuts
• Personalized dashboards
• Custom fields and forms
• Branding options
• Notification preferences
• Language and localization

🛡️ Enterprise Features

• Single Sign-On (SSO) support
• Team and user management
• Audit trails
• Compliance reporting
• Data retention policies
• Advanced backup options
• White-labeling
• Priority support

---

Feature — We are working to add (in progress / planned) 🔁

We keep an active backlog. Below are items called out in the original README (kept as-is, but clarified):

• [ ] desktop app fullstack development
• [ ] flutter and react native support
• [ ] making a custom web view and a real mobile view for flutter and desktop without the need of webcontainers to be more flexible with our own needs
• [ ] Switching to Tauri from Electron for better performance on our desktop version that is in internal beta
• [ ] Working on a CLI
• [ ] Working on an IDE (not the previously listed smack-ide which is no longer maintained) that we will start maintaining again
• [ ] Working on an adblocker that is based on uBlock Origin but upgraded with AI to warn you before going to a dangerous website

If you want a specific feature prioritized, please open an issue describing your use case and impact.

---

Why Smack.sh? 🔍

Smack.sh helps developers iterate on AI-powered applications quickly using a TypeScript-first stack with Remix for web and Electron (or Tauri later) for desktop packaging. The project is early-stage by design: lightweight, modular, and focused on fast experimentation and extensibility.

Keywords: AI agent platform, AI app builder, TypeScript, Remix, Electron, AI workflows, plugin system.

---

Prerequisites

• Node.js >= 18.x
• pnpm (preferred) or npm / yarn
• Docker (optional, for containerized deployments)
• Git

---

Installation

# Clone
git clone https://github.com/smack-sh/smack-sh.git
cd smack-sh

# Install deps (pnpm recommended)
pnpm install

# Copy env example and edit
cp .env.example .env.local
# edit .env.local with API keys / config

---

Development

Web (Remix)

# Start the Remix development server (hot reload)
pnpm run dev
# Open http://localhost:3000

Electron (desktop)

# Run Electron in dev mode
pnpm run electron:dev

Build & Package

# Build the web app and packages
pnpm run build

# Create desktop distributables
pnpm run package:electron

Common scripts (see package.json)

• pnpm run dev — start development (web + optional services)
• pnpm run electron:dev — run Electron in dev mode
• pnpm run build — compile and bundle for production
• pnpm run package:electron — produce desktop packages

---

Production Build

# Build for production
pnpm run build

# Start the production server
pnpm start

Adjust process manager and env variables for production deployments.

---

Docker deployment

Example Dockerfile (reference)

FROM node:18-alpine
WORKDIR /app
COPY package*.json ./
RUN npm ci --production
COPY . .
ENV NODE_ENV=production
RUN npm run build
EXPOSE 3000
CMD ["npm", "run", "start"]

Build & run (example):

pnpm run dockerbuild
pnpm run dockerrun
# OR
docker build -t smack-sh:latest .
docker run -p 3000:3000 smack-sh:latest

Customize for secrets, orchestration, or CI/CD needs.

---

Project structure (high level)

smack.sh/
├── app/                  # Application source code (Remix routes, UI)
├── electron/             # Electron-specific code & packaging config
├── public/               # Static assets
├── packages/             # Shared packages, utilities, plugins
├── scripts/              # Utility & build scripts
├── types/                # TypeScript type definitions
├── .env.example          # Example environment variables
├── package.json          # Project dependencies and scripts
└── README.md             # This file

---

Contributing 🤝

Contributions are welcome — Smack.sh is community-driven.

How to contribute:

1. Search existing issues or open a new one to discuss your idea.
2. Fork the repository and create a branch:

git checkout -b feat/my-feature

1. Add tests and documentation for your change.
2. Push and open a pull request describing the problem and your solution.

Guidelines:

• Keep PRs small and focused.
• Add tests where applicable.
• Update docs and README for user-facing changes.
• Follow TypeScript style and linting rules.
• Respect the Code of Conduct.

Look for labels such as good-first-issue and help-wanted to get started.

---

Contact / Support 💬

• Prefer opening a GitHub Issue for bugs, feature requests, or support: https://github.com/smack-sh/smack-sh/issues
• Use GitHub Discussions (if enabled) for broader conversations.
• You can reach the maintainer via the GitHub profile: https://github.com/DevFlex-AI

Note: Please avoid posting secrets or credentials in public issues.

---

License & Acknowledgements

• License: MIT — see LICENSE. If your repository uses a different or custom license, please update this file accordingly.
• Acknowledgements: Remix, Electron, Vite, TypeScript, and many open-source contributors.

---

Call to Action 🚩

If you find Smack.sh useful:

• Try the Quick Start and get building 🚀
• Star ⭐ this repository to show support
• Fork 🍴 and experiment or contribute
• Open issues and PRs — your feedback shapes the roadmap

Thank you for checking out Smack.sh — an early-stage but powerful TypeScript-first AI app builder. We welcome contributions and community collaboration! 🙏