Skip to content

Risus-Pieces/distro

Repository files navigation

Distro

AI-powered content distribution for startups. Write one brief, get platform-native content for 8 channels — LinkedIn, X/Twitter, Reddit, Facebook, Email, YouTube, Instagram, and TikTok — generated instantly by Claude AI.


What It Does

Distro gives small teams the distribution power of a full marketing department:

  1. Set your voice — Paste your website URL and Distro auto-extracts your brand voice, tone, and style. Edit it to your liking.
  2. Write a brief — Describe what you want to say (e.g., "We just hit 1,000 customers — share the milestone authentically").
  3. Generate — Claude AI creates tailored content for all 8 platforms in seconds, each adapted to the platform's culture, format, and character limits.
  4. Review & post — Edit any post on its dedicated detail page, preview how it looks, and post with one click.
  5. Schedule — Set recurring posting schedules with default briefs, and override specific days with custom campaign content.

How to Run It (Step-by-Step)

Prerequisites

You need two things installed on your computer before starting:

  1. Node.js (version 18 or higher)
  2. Git (to download the code)

How to check if you have them

Open your Terminal (Mac) or Command Prompt (Windows) and type these commands:

node --version

You should see something like v18.17.0 or v20.11.0. Any number 18 or higher is fine.

git --version

You should see something like git version 2.39.0.

If you don't have Node.js

  1. Go to https://nodejs.org
  2. Click the big green button that says "LTS" (Long Term Support)
  3. Download and run the installer
  4. Follow the prompts — just click "Next" / "Continue" through everything
  5. When it's done, close and reopen your Terminal, then try node --version again

If you don't have Git

  1. Go to https://git-scm.com/downloads
  2. Download the installer for your operating system
  3. Run the installer with default settings
  4. Close and reopen your Terminal, then try git --version again

Step 1: Download the code

Open your Terminal and run:

git clone https://github.com/Risus-Pieces/distro.git

Then navigate into the project folder:

cd distro

Step 2: Install dependencies

This downloads all the libraries the app needs. Run:

npm install

This may take 1-2 minutes. You'll see a progress bar. Wait until it finishes and you see your cursor again.


Step 3: Set up your API key

Distro uses Claude AI to generate content. You need an Anthropic API key.

  1. Go to https://console.anthropic.com and sign up (or log in)
  2. Navigate to API Keys in the sidebar
  3. Click Create Key and copy the key (it starts with sk-ant-...)

Now create a file called .env.local in the project folder. You can do this from the Terminal:

On Mac/Linux:

echo 'ANTHROPIC_API_KEY=paste-your-key-here' > .env.local

On Windows (Command Prompt):

echo ANTHROPIC_API_KEY=paste-your-key-here > .env.local

Replace paste-your-key-here with the actual API key you copied.

Note: The .env.local file is already in .gitignore, so your key will never be uploaded to GitHub.


Step 4: Start the app

Run:

npm run dev

You should see output like:

  ▲ Next.js 16.2.2
  - Local: http://localhost:3000

Step 5: Open it in your browser

Open your web browser (Chrome, Safari, Firefox, etc.) and go to:

http://localhost:3000

You should see the Distro dashboard with the logo, sidebar, and the voice profile form.


How to Use It

1. Set up your voice profile

  • Expand the Voice Profile card on the left
  • Paste your website URL into the "Auto-fill from website" field and click Analyze — Claude will extract your brand voice automatically
  • Review and edit the fields: brand name, what you do, tone tags, "never say" words, and "sounds like" description

2. Write your brief

  • In the Brief section below the voice profile, describe what you want to announce or share
  • Click Generate

3. Review your content

  • After generation, the right panel shows cards for all 8 platforms
  • Click any card to go to its detail page where you can:
    • Edit the generated content
    • See a live preview of how it will look on that platform
    • Upload images (LinkedIn) or videos (YouTube, Instagram, TikTok)
    • Post to the platform

4. Schedule posts

  • Click Calendar in the sidebar to view the posting schedule
  • From any platform's detail page, click Schedule to set up recurring posts
  • On the calendar, click any day to add a campaign override with a custom brief

Stopping the App

To stop the app, go back to your Terminal and press:

Ctrl + C

This shuts down the development server.


Starting It Again Later

Whenever you want to run Distro again:

  1. Open your Terminal
  2. Navigate to the project folder: cd distro (or wherever you saved it)
  3. Run: npm run dev
  4. Open http://localhost:3000 in your browser

You do not need to run npm install again — only the first time.


Troubleshooting

Problem Solution
node: command not found Node.js isn't installed. Follow the install instructions above.
npm: command not found npm comes with Node.js. Reinstall Node.js from nodejs.org.
git: command not found Git isn't installed. Follow the install instructions above.
The page is blank or shows an error Make sure you created the .env.local file with your API key. Restart the server with Ctrl+C then npm run dev.
"Generation failed" error Your Anthropic API key may be invalid or out of credits. Check console.anthropic.com.
Port 3000 is already in use Another app is using that port. Run npm run dev -- -p 3001 and open http://localhost:3001 instead.

Built With

  • Next.js — React framework
  • TypeScript — Type-safe JavaScript
  • Tailwind CSS — Styling
  • Claude AI (Anthropic API) — Content generation and brand voice analysis
  • Resend — Email delivery
  • LinkedIn, Twitter, Reddit APIs — Social media posting

About

fully integrated distribution layer

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

No releases published

Packages

 
 
 

Contributors