Ship, Change, Rawr
Changerawr lets you write down what you changed, then share those changes with people. You write entries about updates you made, and Changerawr gives you ways to display them - like widgets for your website, public pages people can visit, or APIs to use however you want.
You can think of it as a Changelog Management System [CMS]
If you don't know what a changelog is, check out betterauth for an example!
Developer-focused. Headless API, beautiful documentation, SDKs, integrations, and a CLI.
Fully customizable. Do things your way. No vendor lock-in, no forced workflows.
For everyone. Whether you're a solo developer, small business, or enterprise team - Changerawr scales with you. ( yes, this means you can use it for commercial usage! just please do reach out if you do, I would love to know how your using Changerawr! )
- 📝 Beautiful Content Editor - Write changelogs that look professional
- 🤖 AI-Powered - Let AI help you write better changelog entries
- 📡 Headless API - Beautifully documented REST API for full control
- 🧩 SDKs - Pre-built libraries for popular languages
- 🎨 Embeddable Widget - Drop a changelog widget anywhere on your site
- 📧 Email Notifications - Keep users informed of updates
- 🏷️ Tags & Versioning - Organize entries exactly how you want
- 🔗 Multiple Integrations - Connect with your existing tools
- 🔐 Modern Authentication - Custom-built auth with passkey support
- 🖥️ Desktop-First Design - Built for desktop use (mobile works, but it's quirky)
- 🔍 Full-Text Search - Search everything, instantly
- -🌐 Custom Domains - Link a custom domain to your changelog
- Node.js 18+
- PostgreSQL database
# Clone the repository
git clone https://github.com/supernova3339/changerawr.git
cd changerawr
# Install dependencies
npm install
# Set up environment
cp .env.example .env.local
# Edit .env.local with your settings
# Set up database
npx prisma generate
npx prisma migrate deploy
# Build the widget
npm run build:widget
# Start development server
npm run devVisit http://localhost:3000 and you're ready to go!
docker-compose up --build# Database
DATABASE_URL="postgresql://postgres@localhost:5432/changerawr?schema=public"
# Authentication
JWT_ACCESS_SECRET="your-jwt-secret-key"
NEXT_PUBLIC_APP_URL="http://localhost:3000"
# GitHub Integration (optional)
GITHUB_ENCRYPTION_KEY="your-github-encryption-key"
# Analytics
ANALYTICS_SALT="your-secure-random-salt-here"The easiest way to add changelogs to your site - perfect for non-technical users:
<!-- Basic widget -->
<script
src="https://your-changerawr.com/api/widget/your-project-id"
data-theme="light"
async
></script>
<!-- Popup widget -->
<button id="updates-btn">What's New?</button>
<script
src="https://your-changerawr.com/api/widget/your-project-id"
data-popup="true"
data-trigger="updates-btn"
async
></script>| Option | Type | Default | Description |
|---|---|---|---|
data-theme |
string | "light" | Theme: "light" or "dark" |
data-position |
string | "bottom-right" | Popup position |
data-max-height |
string | "400px" | Maximum height |
data-popup |
boolean | false | Enable popup mode |
data-trigger |
string | null | Button ID or "immediate" |
data-max-entries |
number | 3 | Amount of entries to display, min 3 max 10 |
Built with modern, reliable technologies:
- Next.js 16 - React framework with App Router
- Prisma ORM - Type-safe database access
- PostgreSQL - Robust, scalable database
- Shadcn/UI - Beautiful, accessible UI components
- TypeScript - Full type safety throughout
npm run dev # Development server
npm run build # Production build
npm run start # Start built development serer
npm run start:prod # Start production server
npm run start:prod:win # Start production server ( Windows )
npm run build:widget # Build embeddable widget
npm run generate-swagger # Generate API docs
npm run lint # Code linting ( next 16 will depc this - note )
npm run maintenance # Run the maintenance page
npm run start:with-maintenance # Runs maintenance page and the main server
npm run prisma:studio # Database viewer and manager
changerawr/
├── app/ # Next.js App Router
│ ├── (auth)/ # Auth pages
│ ├── (email)/ # Newsletter related pages
│ ├── api/ # API endpoints
│ ├── api-docs/ # API Documentation
| ├── changelog/ # Changelog pages (public/custom-domain)
│ ├── cli/ # Internal pages used to interface with the Changerawr CLI
│ └── dashboard/ # Main app
├── components/ # React components
├── lib/ # Core utilities
├── prisma/ # Database schema
├── widgets/ # Widget source
├── scripts/ # Build scripts
└── emails/ # Email templates
# Build
docker build -t changerawr .
# Run
docker run -p 3000:3000 \
-e DATABASE_URL="your-database-url" \
-e JWT_ACCESS_SECRET="your-secret" \
-e NEXT_PUBLIC_APP_URL="your-app-url" \
-e GITHUB_ENCRYPTION_KEY="your-encryption-key-32-chars" \
-e ANALYTICS_SALT="your-analytics-salt" \
changerawrnpm run build
npx prisma migrate deploy
npm run build:widget
npm run generate-swagger
npm start:with-maintenanceLet AI help you craft professional changelog entries that your users will actually want to read.
Built from scratch with modern features like passkeys. No third-party restrictions, full control.
Clean, well-documented REST API with SDKs for popular languages. Build exactly what you need.
Keep your users in the loop with beautiful email updates when you ship new features.
Tags, versioning - organize your changelogs exactly how your team works.
We welcome contributions! Whether it's:
- 🐛 Bug fixes
- ✨ New features
- 📖 Documentation improvements
- 🎨 UI/UX enhancements
- Fork the repo
- Create a feature branch
- Make your changes
- Submit a pull request
Non-Commercial Open Source License - see LICENSE for details.
Changerawr is open source and free to use, modify, and fork (including closed-source versions). You can use it commercially in your business, but you cannot profit from selling the software itself or charge users for access to it. All features remain free forever.
- 🐛 Issues: GitHub Issues
- 💬 Discussions: GitHub Discussions
Built by developers, for developers.
