boxyhq / saas-starter-kit

🔥 Enterprise SaaS Starter Kit - Kickstart your enterprise app development with the Next.js SaaS boilerplate 🚀
https://boxyhq.com/blog/enterprise-ready-saas-starter-kit
Apache License 2.0
3.47k stars 805 forks source link

Update README with detailed step for each feature configuration #50

Open niwsa opened 2 years ago

thevinitgupta commented 1 year ago

Could you provide more context about the issue?

devkiran commented 1 year ago

Sure, boxyhq/saas-starter-kit uses various services (Jackson, Retraced, Svix, etc). We need to update the README with detailed steps for each feature configuration. For example, how to configure Jackson, how to configure Retraced, etc. So that it is easy for the user to follow the steps and configure the services.

dasveloper commented 1 year ago

Sure, boxyhq/saas-starter-kit uses various services (Jackson, Retraced, Svix, etc). We need to update the README with detailed steps for each feature configuration. For example, how to configure Jackson, how to configure Retraced, etc. So that it is easy for the user to follow the steps and configure the services.

I'd also love if the readme could have some descriptions about why we're setting up certain things, like I see we're using Svix to emit on user/team CRUD operations, but why? Is it just an example or is that required for some functionality?

Rbcoder1 commented 1 year ago

I have register for hacktoberfest2023. Can you please assign this issue so started to work on it

Rbcoder1 commented 1 year ago

I work on it

Rbcoder1 commented 1 year ago

I Need To Add A Seperate Section For This Detail Steps

Rbcoder1 commented 1 year ago

This Are The Services We Are Using So I Need To Write Steps To Configure Them Ok

devkiran commented 1 year ago

@Rbcoder1 For SAML Jackson, Svix and Retraced. Link to the right documentation.

Rbcoder1 commented 1 year ago

Where I Add These Step Section In Readme

devkiran commented 1 year ago

Add a new section under Features

Rbcoder1 commented 1 year ago

Ok

On Fri, 6 Oct 2023, 11:00 am Kiran K, @.***> wrote:

Add a new section under Features

— Reply to this email directly, view it on GitHub https://github.com/boxyhq/saas-starter-kit/issues/50#issuecomment-1750006998, or unsubscribe https://github.com/notifications/unsubscribe-auth/AZRVEQV2OJRDZWIEL3SERBDX56JQZAVCNFSM6AAAAAARF7WKC2VHI2DSMVQWIX3LMV43OSLTON2WKQ3PNVWWK3TUHMYTONJQGAYDMOJZHA . You are receiving this because you were mentioned.Message ID: @.***>

tobalo commented 5 months ago

Can we get some renewed focus on this? Having minimum .env config or add all setup steps would help for new adopters. For example having guided output on dependency setup or npm run dev failures would be helpful

Getting my dev environment running with a DB and minimal .env config. This is my current output - any guidance appreciated:

npm run dev

> saas-starter-kit@1.5.0 dev
> next dev --port 4002

  â–² Next.js 14.2.4
  - Local:        http://localhost:4002
  - Environments: .env
  - Experiments (use with caution):
    · esmExternals
    · webpackBuildWorker
    · instrumentationHook

 ✓ Starting...

Then exits process

niwsa commented 5 months ago

@tobalo We have an example env here: https://github.com/boxyhq/saas-starter-kit/blob/main/.env.example . Does that help ? Could you outline the specific issue that you are facing ?