✨ Initial release of CommitFlow — AI-powered GitHub Insight & Project Management Tool

Author: asepindrak

.env.sample

@@ -0,0 +1,43 @@
+# ENV
+NODE_ENV="development"
+
+# LOGGER
+DISCORD_WEBHOOK_URL=
+LOG_LEVEL=info
+
+# PostgreSQL
+POSTGRES_USER=postgres
+POSTGRES_PASSWORD=password
+POSTGRES_DB=commitflow
+DB_PORT=5432
+
+# pgAdmin
+PGADMIN_EMAIL=admin@example.com
+PGADMIN_PASSWORD=admin123
+ADMIN_PORT=8080
+
+# Prisma (change db to localhost if not using docker)
+DATABASE_URL=postgresql://postgres:password@db:5432/commitflow
+
+# Backend
+BE_PORT=8000
+OPENAI_API_KEY=
+BASE_URL=http://localhost:8000
+API_KEY=""
+JWT_SECRET=""
+
+# Github user or org
+GITHUB_OWNER=
+GITHUB_TOKEN=
+
+# Frontend
+FE_PORT=3000
+VITE_API_URL="http://localhost:8000"
+
+# S3 Storage
+S3_BUCKET_NAME=
+S3_REGION=
+S3_ACCESS_KEY=
+S3_SECRET_KEY=
+# S3 COMPATIBLE STORAGE
+S3_ENDPOINT_URL=

.gitignore

@@ -0,0 +1 @@
+.env

CODE_OF_CONDUCT.md

@@ -0,0 +1,45 @@
+# 🌍 CommitFlow Code of Conduct
+
+We are committed to fostering an open, welcoming, and inclusive community for everyone.  
+Please follow these guidelines to help maintain a positive environment.
+
+---
+
+## 💬 Our Pledge
+
+We pledge to make participation in our community a harassment-free experience for everyone, regardless of age, gender, sexual orientation, disability, physical appearance, body size, race, ethnicity, religion, or technical background.
+
+---
+
+## 🤝 Our Standards
+
+Examples of behavior that contributes to a positive environment include:
+- Using welcoming and inclusive language  
+- Respecting different viewpoints and experiences  
+- Providing constructive feedback  
+- Showing empathy toward other community members  
+
+Examples of unacceptable behavior include:
+- Harassment or discriminatory language  
+- Personal attacks or insults  
+- Publishing others’ private information  
+- Disruptive or unprofessional conduct  
+
+---
+
+## 🛠 Enforcement
+
+Project maintainers are responsible for clarifying and enforcing this Code of Conduct.  
+If you experience or witness behavior that violates these guidelines, please report it by opening an issue or contacting a project maintainer.
+
+---
+
+## ⚖️ Scope
+
+This Code of Conduct applies to all spaces related to the project, both online and offline, including code repositories, issue trackers, discussion forums, and social media.
+
+---
+
+## ❤️ Attribution
+
+This Code of Conduct is adapted from the [Contributor Covenant](https://www.contributor-covenant.org/), version 2.1.

CONTRIBUTING.md

@@ -0,0 +1,109 @@
+# 🤝 Contributing to CommitFlow
+
+Thank you for your interest in contributing to **CommitFlow** — an open-source AI-powered GitHub Insight & Project Management tool.  
+We welcome all contributions, from small documentation fixes to major feature implementations.
+
+---
+
+## 🧭 Getting Started
+
+1. **Fork** this repository and clone it locally:
+    ```bash
+    git clone https://github.com/asepindrak>/commitflow.git
+    cd commitflow
+    ```
+
+2. Create a new branch for your changes:
+    ```bash
+    git checkout -b feat/your-feature-name
+    ```
+
+3. Make your changes and ensure everything works:
+    ```bash
+    npm run lint
+    npm run test
+    ```
+
+4. Commit your changes using Conventional Commits:
+    ```bash
+    feat: add new AI insight generator
+    fix: resolve API token validation issue
+    chore: update Docker build script
+    ```
+
+5. Push your branch and open a Pull Request (PR):
+    ```bash
+    git push origin feat/your-feature-name
+    ```
+
+---
+
+## 🧱 Development Setup ✨
+
+To run the project locally using Docker:
+
+    ```bash
+    ./scripts/build.dev.sh
+    ```
+
+Access the services:
+
+- Frontend: http://localhost:3000
+
+- Backend: http://localhost:8000
+
+- pgAdmin: http://localhost:8080
+
+If you’re running it for the first time, migrate the database:
+    ```bash
+    docker exec -it commitflow-api npx prisma db push
+    ```
+
+---
+
+## 🧠 Commit Message Convention ✨
+We follow Conventional Commits:
+| Type        | Description                                           |
+| ----------- | ----------------------------------------------------- |
+| `feat:`     | A new feature                                         |
+| `fix:`      | A bug fix                                             |
+| `docs:`     | Documentation only changes                            |
+| `style:`    | Code style (formatting, etc.)                         |
+| `refactor:` | Code changes that neither fix a bug nor add a feature |
+| `perf:`     | Performance improvements                              |
+| `test:`     | Adding or fixing tests                                |
+| `chore:`    | Maintenance or build tasks                            |
+
+Example:
+    ```bash
+    feat: integrate GitHub API for contribution tracking
+    ```
+
+
+## 🧪 Running Tests ✨
+
+If tests are available, you can run them with:
+
+    ```bash
+    npm test
+    ```
+---
+
+## 🧾 Submitting Issues ✨
+
+When reporting a bug or suggesting a feature:
+
+- Check if an issue already exists.
+- Include steps to reproduce, expected behavior, and screenshots (if applicable).
+- Use a clear and descriptive title.
+
+
+## ❤️ Code of Conduct ✨
+
+By contributing, you agree to follow our Code of Conduct
+
+
+## 🌟 Thank You!
+
+Your contributions make CommitFlow better for everyone.
+We appreciate your time, effort, and ideas 💫.

LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Asep Kurniawan
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in
+all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+THE SOFTWARE.