Align · Collaborate · Achieve
_{Where teams move in sync — with clarity, control, and confidence.}

Syncra is a full-stack Project Management & Collaboration Platform designed to help teams plan, track, and execute work efficiently.

It centralizes workspaces, projects, tasks, communication, analytics, and automation into a single system—reducing chaos and ensuring no task or deadline is missed.

• Workspace-based organization for teams
• Project creation with defined goals
• Task management with assignees, priority, status, and due dates
• Clear ownership and progress visibility

• Invite members via email
• Real-time task-level comments
• Role-Based Access Control (Admin / Member)

• Automated email reminders 24 hours before task deadlines
• Background cron jobs using Inngest
• Transactional emails via Nodemailer + Brevo SMTP

• Responsive UI with React (Vite) and Tailwind CSS
• Dark & Light mode support
• Secure authentication powered by Clerk

• Auth Layer: Clerk handles authentication and session management
• API Layer: Express.js REST APIs with middleware protection
• Database Layer: PostgreSQL with Prisma ORM
• Async Jobs: Inngest for reminders and background workflows
• Notifications: Nodemailer integrated with Brevo SMTP
• Frontend: React (Vite) with Redux Toolkit

erDiagram
    USER ||--o{ WORKSPACE_MEMBER : belongs_to
    WORKSPACE ||--o{ WORKSPACE_MEMBER : has
    WORKSPACE ||--o{ PROJECT : contains
    PROJECT ||--o{ TASK : has
    TASK ||--o{ COMMENT : receives
    USER ||--o{ TASK : assigned_to
    USER ||--o{ COMMENT : writes

    USER {
      string id
      string email
      string name
    }

    WORKSPACE {
      string id
      string name
    }

    PROJECT {
      string id
      string name
    }

    TASK {
      string id
      string title
      string status
      string priority
      datetime dueDate
    }

    COMMENT {
      string id
      string content
    }

The database schema is designed for flexibility and relational integrity.

User 
 └── WorkspaceMember
      └── Workspace
           └── Project
                └── Task
                     └── Comment

• Users can be members of multiple Workspaces.
• Workspaces contain multiple Projects.
• Projects are broken down into Tasks.
• Tasks have properties like status and deadlines, and support threads of Comments.

Syncra follows a modern monorepo structure.

Syncra/
├── backend/                # Node.js & Express API
│   ├── configs/            # Services setup (Prisma, SMTP)
│   ├── controllers/        # Business logic & request handling
│   ├── inngest/            # Background job functions
│   ├── middlewares/        # Auth verification
│   ├── prisma/             # Database schema & migrations
│   └── server.js           # Application entry point
│
└── frontend/               # React (Vite) Client
    ├── src/
    │   ├── components/     # Reusable UI elements
    │   ├── features/       # Redux state slices
    │   └── pages/          # Application views
    └── vite.config.js

All APIs are RESTful and secured via Clerk authentication. Base URL: /api/v1

Run Syncra locally in a few simple steps.

• Node.js (v16+) & npm
• PostgreSQL Database
• Clerk Account (for auth keys)
• Brevo / SMTP Account (for emails)

git clone [https://github.com/devbyhimans/Syncra.git](https://github.com/devbyhimans/Syncra.git)
cd Syncra

Navigate to the backend directory and install dependencies:

cd backend
npm install

Create a .env file and add your credentials:

DATABASE_URL="postgresql://user:password@localhost:5432/syncra_db"
CLERK_PUBLISHABLE_KEY="pk_test_..."
CLERK_SECRET_KEY="sk_test_..."
SMTP_HOST="smtp-relay.brevo.com"
SMTP_PORT=587
SMTP_USER="your_email@example.com"
SMTP_PASS="your_smtp_password"
SENDER_EMAIL="no-reply@syncra.com"

Run database migrations and start the server:

npx prisma migrate dev --name init
npm start

Open a new terminal, navigate to the frontend directory, and install dependencies:

cd ../frontend
npm install

Create a .env file for the frontend:

VITE_CLERK_PUBLISHABLE_KEY="pk_test_..."

Start the development server:

npm run dev

Visit http://localhost:5173 to use Syncra!

• Authentication: Secured by Clerk, handling user sessions and identities.
• Authorization: API routes are protected by middleware, ensuring only authenticated users access data.
• RBAC: Critical actions (e.g., workspace settings) are restricted to Admins.
• Data Validation: Inputs are validated to prevent common injection attacks.

• In-App Notifications: Real-time alerts in addition to emails.
• File Attachment Support: Upload files to tasks and projects.
• Calendar Integration: Sync tasks with Google/Outlook calendars.
• AI-Powered Insights: Smart predictions for project timelines.

Contributions are welcome! Please fork the repository, create a feature branch, and submit a Pull Request.

This project is licensed under the MIT License.

Himanshu

• GitHub: @devbyhimans
• Project Link: https://github.com/devbyhimans/Syncra

Built with ❤️ by Himanshu