Shareville

Shareville is a third-party web application tool designed to simplify social media post management, starting with seamless integration for scheduling and instant posting to Facebook pages. It offers an embeddable widget that can be integrated into websites (e.g., AI image generation platforms) to enable users to connect their Facebook accounts, share media, and schedule posts with ease. Shareville prioritizes a user-friendly experience for linking accounts and managing posts, backed by a robust infrastructure for data and scheduling tasks.

Features

• Seamless Facebook Integration: Users can securely connect their Facebook accounts and pages through a straightforward OAuth flow.
• Post Scheduling & Instant Sharing: Share images or media to Facebook pages instantly or schedule posts via an intuitive widget.
• Reusable Widget: Easily embeddable in any website (e.g., NextJS-based platforms) to manage social media posting without code duplication.
• Real-Time Status Updates: Webhooks deliver live updates on post statuses, viewable on the host website.
• Scalable Design: Built to support integration with multiple websites and future social media platforms.

Tech Stack

• Frontend Widget: NextJS, React, TypeScript, Tailwind CSS, Shadcn UI
• Backend API: BunJS, HonoJS Framework, Drizzle ORM
• Database: PostgreSQL, Redis
• Queue: BullMQ with Redis
• Authentication: Better-Auth
• Hosting: Self-managed VPS Server

Purpose

Shareville eliminates the need for repetitive social media integration by providing a standalone, reusable tool that simplifies connecting and posting to Facebook pages. It’s designed for scalability, enabling seamless integration with various websites while offering an effortless post management experience.

Getting Started

1. Clone the repository: git clone https://github.com/[your-username]/shareville.git
2. Install dependencies: bun install (backend) and npm install (frontend)
3. Configure environment variables for PostgreSQL, Redis, and Facebook API credentials.
4. Run the backend: bun run start
5. Run the frontend widget: npm run dev
6. Integrate the Shareville widget into your NextJS website and start sharing!

Contributing

Contributions are welcome! Please read our Contributing Guidelines for details on how to submit pull requests, report issues, or suggest features.

Apps and Packages

• docs: a Next.js app
• web: another Next.js app
• @repo/ui: a stub React component library shared by both web and docs applications
• @repo/eslint-config: eslint configurations (includes eslint-config-next and eslint-config-prettier)
• @repo/typescript-config: tsconfig.jsons used throughout the monorepo

Each package/app is 100% TypeScript.

Utilities

This Turborepo has some additional tools already setup for you:

• TypeScript for static type checking
• ESLint for code linting
• Prettier for code formatting

Build

To build all apps and packages, run the following command:

cd my-turborepo
pnpm build

Develop

To develop all apps and packages, run the following command:

cd my-turborepo
pnpm dev

Remote Caching

Tip

Vercel Remote Cache is free for all plans. Get started today at vercel.com.

Turborepo can use a technique known as Remote Caching to share cache artifacts across machines, enabling you to share build caches with your team and CI/CD pipelines.

By default, Turborepo will cache locally. To enable Remote Caching you will need an account with Vercel. If you don't have an account you can create one, then enter the following commands:

cd my-turborepo
npx turbo login

This will authenticate the Turborepo CLI with your Vercel account.

Next, you can link your Turborepo to your Remote Cache by running the following command from the root of your Turborepo:

npx turbo link

Useful Links

Learn more about the power of Turborepo:

• Tasks
• Caching
• Remote Caching
• Filtering
• Configuration Options
• CLI Usage

---