raystack / raystack/frontier

Allow Dynamic Project Name Generation from Project Title in SDK

Open
#1,292 1 comment 0 reactions 0 assignees View on GitHub

Nobody has claimed this yet.

Dominant language
Go
Stars
344
Forks
47
Avg merge
4d 4h
Merged PRs (30d)
26

Description

Problem

Some clients want to create projects using only the project title without requiring users to input a globally unique project name. Currently, both fields must be provided during project creation, which creates friction in the user experience.

Proposed Solution

Implement project name auto-generation in the JS SDK using the format:
{sanitizedproject_title}{md5_hash_of_org_uuid}

Example:

  • Project Title: My Project
  • Organization UUID: 123e4567-e89b-12d3-a456-426614174000
  • Generated Name: my_project_8f14e45fceea167a5a36deebd9c0e6a1
Why SDK Over Schema Changes
  1. Preserves Data Integrity: The globally unique project name constraint is essential for system-wide uniqueness and should remain unchanged at the database level.

  2. Backward Compatibility: Existing clients and APIs continue to work without breaking changes. Clients who want to provide explicit names still can.

  3. Client-Side Flexibility: Different SDK implementations (JS, Go, Python) can adopt this pattern independently based on their use cases without forcing schema migrations.

  4. Separation of Concerns: The uniqueness requirement is a data layer constraint, while the auto-generation is a UX enhancement that belongs in the presentation/SDK layer.

  5. No Migration Required: Schema changes would require database migrations across all deployments, while SDK changes can be adopted incrementally.

Benefits

  • Improved UX for clients who find project names redundant
  • No breaking changes to existing infrastructure
  • Maintains data integrity and uniqueness guarantees
  • Easy to roll out and test incrementally
  • Configurable behavior allows gradual adoption

Contributor guide

No contributing guide indexed for this repository

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

Research direction

Start at the JS SDK's project-creation entry point and trace how the project title, organization UUID, and explicit project name are handled. Verify the proposed sanitized-title plus MD5 organization UUID behavior, preserve explicit names, and add or update SDK tests covering both paths.

Written by the indexing model from the issue text.

Assessment

Tech stack
javascript
Domain
api, developer-experience
Issue type
Feature
Difficulty
3/5
Estimated time
1-2 days
Activity status
Stale
Clarity
Mostly clear
Newbie friendliness
35/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.