Skip to content

CONTRIBUTING.md

Latest commit

 

History

History
77 lines (56 loc) · 2.68 KB

CONTRIBUTING.md

File metadata and controls

77 lines (56 loc) · 2.68 KB
Raw

Contributing to Debo

First off, thank you for considering contributing to Debo! We value your help in building a better Life Intelligence System.

🕯️ Our Philosophy: Editorial Calm

Debo is designed to be a "quietly-confident" space for reflection. When contributing UI changes:

  • Prioritize Typography: Use large, readable headings and JetBrains Mono for metadata.
  • Warm Aesthetics: Avoid pure whites and blacks; use the cream canvas (`#f7f7f4`) and warm ink (`#26251e`).
  • Minimal Depth: No drop shadows. Use 1px hairlines for separation.
  • Generous Rhythm: Maintain an 80px vertical rhythm between major sections.

🛠️ Development Setup

1. Prerequisites

2. Initial Setup

```bash

Fork and clone the repository

git clone https://github.com/YOUR_USERNAME/debo.git cd debo

Install dependencies

bun install

Setup environment variables

cp .env.example .env.local

Edit .env.local with your keys

```

3. Database & Auth

```bash

Sync your database schema

bun run db:push

Generate Cloudflare types (if working on workers)

bun run cf-typegen ```

4. Run Development Server

```bash bun run dev ```

💻 Coding Standards

  • React 19 & Next.js 16: Use functional components, Server Components by default, and Server Actions for data mutations.
  • TypeScript: Strict type safety is required. Avoid `any`.
  • Styling: Tailwind CSS v4. Stick to the design tokens defined in `tailwind.config.ts`.
  • Orchestration: Agent logic should be added to `src/mastra/agents` and tools to `src/mastra/tools`.
  • Database: Use Drizzle ORM for all database operations.

🌿 Branching & PRs

  1. Create a branch: `git checkout -b feat/your-feature-name` or `fix/bug-name`.
  2. Make your changes and ensure they follow the design philosophy.
  3. Run linting: `bun run lint`.
  4. Open a Pull Request against the `main` branch.
  5. Provide a clear description and screenshots (for UI changes).

🚩 Reporting Issues

  • Bug Reports: Provide steps to reproduce, expected vs. actual behavior, and environment details.
  • Feature Requests: Explain the "Why" and "How" it fits into the Life Intelligence System.

📜 Code of Conduct

By participating in this project, you agree to abide by our Code of Conduct.

📄 License

By contributing, you agree that your contributions will be licensed under the MIT License.