{"id":51431639,"url":"https://github.com/devadarshh/flashbot","last_synced_at":"2026-07-05T04:30:21.404Z","repository":{"id":369081929,"uuid":"1273989407","full_name":"devadarshh/flashbot","owner":"devadarshh","description":"About A lightning-fast, modern support widget and dashboard for SaaS businesses grounded in scraped business knowledge via a RAG pipeline. Strict tenant data isolation, sub-100ms query targets.","archived":false,"fork":false,"pushed_at":"2026-07-03T13:17:38.000Z","size":446,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-07-03T15:04:47.219Z","etag":null,"topics":["backend","frontend","fullstack","githubactions","nextjs","nodejs","react"],"latest_commit_sha":null,"homepage":"https://flashbot.adarshsingh.xyz/","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/devadarshh.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2026-06-19T04:39:00.000Z","updated_at":"2026-07-03T13:17:42.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/devadarshh/flashbot","commit_stats":null,"previous_names":["devadarshh/flashbot"],"tags_count":null,"template":false,"template_full_name":null,"purl":"pkg:github/devadarshh/flashbot","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/devadarshh%2Fflashbot","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/devadarshh%2Fflashbot/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/devadarshh%2Fflashbot/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/devadarshh%2Fflashbot/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/devadarshh","download_url":"https://codeload.github.com/devadarshh/flashbot/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/devadarshh%2Fflashbot/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":35143802,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-26T15:22:16.424Z","status":"online","status_checked_at":"2026-07-05T02:00:06.290Z","response_time":100,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["backend","frontend","fullstack","githubactions","nextjs","nodejs","react"],"created_at":"2026-07-05T04:30:18.677Z","updated_at":"2026-07-05T04:30:21.387Z","avatar_url":"https://github.com/devadarshh.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003cdiv align=\"center\"\u003e\n\n  \u003ch1\u003e🚀 Flashbot\u003c/h1\u003e\n  \u003cp\u003e\n    \u003cstrong\u003eA lightning-fast, modern support widget and dashboard for your SaaS.\u003c/strong\u003e\n  \u003c/p\u003e\n\n  \u003cp\u003e\n    \u003ca href=\"https://nextjs.org\"\u003e\u003cimg src=\"https://img.shields.io/badge/Next.js-15-black?style=for-the-badge\u0026logo=next.js\" alt=\"Next.js\" /\u003e\u003c/a\u003e\n    \u003ca href=\"https://tailwindcss.com\"\u003e\u003cimg src=\"https://img.shields.io/badge/Tailwind_CSS-3.4-38B2AC?style=for-the-badge\u0026logo=tailwind-css\" alt=\"Tailwind CSS\" /\u003e\u003c/a\u003e\n    \u003ca href=\"https://ui.shadcn.com\"\u003e\u003cimg src=\"https://img.shields.io/badge/Shadcn_UI-Radix-black?style=for-the-badge\u0026logo=radix-ui\" alt=\"Shadcn UI\" /\u003e\u003c/a\u003e\n    \u003ca href=\"https://orm.drizzle.team\"\u003e\u003cimg src=\"https://img.shields.io/badge/Drizzle_ORM-PostgreSQL-C5F74F?style=for-the-badge\u0026logo=postgresql\u0026logoColor=black\" alt=\"Drizzle ORM\" /\u003e\u003c/a\u003e\n    \u003ca href=\"https://www.docker.com\"\u003e\u003cimg src=\"https://img.shields.io/badge/Docker-Ready-2496ED?style=for-the-badge\u0026logo=docker\" alt=\"Docker\" /\u003e\u003c/a\u003e\n  \u003c/p\u003e\n\n  \u003cp\u003e\n    \u003cstrong\u003e\u003ca href=\"https://flashbot.adarshsingh.xyz/\"\u003e🌐 Live Demo\u003c/a\u003e\u003c/strong\u003e\n  \u003c/p\u003e\n\n  \u003cp\u003e\n    \u003ca href=\"#features\"\u003eFeatures\u003c/a\u003e •\n    \u003ca href=\"#getting-started\"\u003eGetting Started\u003c/a\u003e •\n    \u003ca href=\"#deployment\"\u003eDeployment\u003c/a\u003e •\n    \u003ca href=\"#tech-stack\"\u003eTech Stack\u003c/a\u003e\n  \u003c/p\u003e\n\u003c/div\u003e\n\n\u003cbr /\u003e\n\n## ✨ Features\n\n- **⚡ Embeddable Widget**: A lightweight, high-performance support widget you can drop into any website.\n- **📊 Admin Dashboard**: Comprehensive dashboard to manage tickets, view analytics, and configure settings.\n- **🎨 Modern UI/UX**: Built with **Shadcn UI** and **Tailwind CSS** for a sleek, accessible, and responsive design.\n- **🔒 Secure Authentication**: Robust authentication system powered by Scalekit.\n- **🗄️ Database Management**: Type-safe database interactions with **Drizzle ORM** and **PostgreSQL**.\n- **🐳 Dockerized**: Fully containerized for easy deployment and scalability.\n- **🤖 CI/CD Ready**: Automated build and deployment pipelines using **GitHub Actions**.\n\n## 🛠️ Tech Stack\n\n- **Framework**: [Next.js 15](https://nextjs.org/) (App Router)\n- **Language**: [TypeScript](https://www.typescriptlang.org/)\n- **Styling**: [Tailwind CSS](https://tailwindcss.com/) \u0026 [Shadcn UI](https://ui.shadcn.com/)\n- **Database**: [PostgreSQL](https://www.postgresql.org/)\n- **ORM**: [Drizzle ORM](https://orm.drizzle.team/)\n- **Deployment**: [Docker](https://www.docker.com/) \u0026 [GitHub Actions](https://github.com/features/actions)\n\n## 🚀 Getting Started\n\n### Prerequisites\n\n- Node.js 18+\n- Docker (optional, for containerized run)\n- PostgreSQL Database\n\n### Installation\n\n1.  **Clone the repository**:\n\n    ```bash\n    git clone https://github.com/your-username/flashbot.git\n    cd flashbot\n    ```\n\n2.  **Install dependencies**:\n\n    ```bash\n    npm install\n    # or\n    yarn install\n    # or\n    pnpm install\n    ```\n\n3.  **Environment Setup**:\n    Create a `.env` file in the root directory and add the following variables:\n\n    ```env\n    # Database\n    DATABASE_URL=\"postgres://user:password@host:port/database?sslmode=no-verify\"\n\n    # Scalekit (Auth)\n    SCALEKIT_ENVIRONMENT_URL=\"https://flashbot.scalekit.dev\"\n    SCALEKIT_CLIENT_ID=\"your-client-id\"\n    SCALEKIT_CLIENT_SECRET=\"your-client-secret\"\n    SCALEKIT_REDIRECT_URI=\"http://localhost:3000/api/auth/callback\"\n    SCALEKIT_WEBHOOK_SECRET=\"your-webhook-secret\"\n\n    # AI \u0026 Tools\n    MISTRAL_API_KEY=\"your-mistral-api-key\"\n    MISTRAL_MODEL=\"mistral-small-latest\"\n    ZENROWS_API_KEY=\"your-zenrows-api-key\"\n\n    # Security\n    JWT_SECRET=\"your-jwt-secret\"\n    ```\n\n4.  **Database Migration**:\n    Push the schema to your database:\n\n    ```bash\n    npm run db:push\n    ```\n\n5.  **Run Development Server**:\n    ```bash\n    npm run dev\n    ```\n    Open [http://localhost:3000](http://localhost:3000) to view the application.\n\n## 📦 Deployment\n\nThis project is optimized for deployment on AWS EC2 using Docker and GitHub Actions.\n\n### Manual Deployment (Docker)\n\n1.  **Build the image**:\n\n    ```bash\n    docker build -t flashbot .\n    ```\n\n2.  **Run the container**:\n    ```bash\n    docker run -p 3000:3000 --env-file .env flashbot\n    ```\n\n### Automated Deployment (GitHub Actions)\n\nWe use GitHub Actions to automatically build and deploy the application to your EC2 instance on every push to `main`.\n\n1.  **Configure Secrets**: Add `EC2_HOST`, `EC2_USER`, and `EC2_KEY` to your repository secrets.\n2.  **Push to Main**: The workflow will handle the rest!\n\n## 📂 Project Structure\n\n```bash\n.\n├── app/                  # Next.js App Router pages\n│   ├── api/              # API Routes\n│   ├── dashboard/        # Dashboard views\n│   └── embed/            # Embeddable widget code\n├── components/           # Reusable UI components\n├── db/                   # Database schema and client\n├── drizzle/              # Migration files\n├── lib/                  # Utility functions\n├── public/               # Static assets\n└── ...\n```\n\n## 🤝 Contributing\n\nContributions are welcome! Please feel free to submit a Pull Request.\n\n## 📄 License\n\nThis project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdevadarshh%2Fflashbot","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fdevadarshh%2Fflashbot","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdevadarshh%2Fflashbot/lists"}