mirror of https://github.com/stack-auth/stack.git synced 2026-06-13 21:01:21 +08:00

History

Zai Shi 2b5eebcd22 Config override CRUD (#803 ) <!-- Make sure you've read the CONTRIBUTING.md guidelines: https://github.com/stack-auth/stack-auth/blob/dev/CONTRIBUTING.md --> <!-- ELLIPSIS_HIDDEN --> ---- > [!IMPORTANT] > Add admin-only API endpoints and UI support for project configuration overrides, with comprehensive tests and documentation updates. > > - New Features: > - Added admin-only API endpoints for reading and updating project configuration overrides in `config/crud.tsx` and `config/override/crud.tsx`. > - Admin app supports fetching, caching, and updating configuration overrides with new React hooks in `admin-app-impl.ts`. > - Bug Fixes: > - Validation and error handling for OAuth providers, duplicate IDs, and invalid config fields in `oauth-providers/crud.tsx`. > - Tests: > - Added end-to-end tests for configuration management and validation errors in `config.test.ts` and `js/config.test.ts`. > - Documentation: > - Updated API documentation for new config override endpoints in `config.ts`. > > <sup>This description was created by </sup>[<img alt="Ellipsis" src="https://img.shields.io/badge/Ellipsis-blue?color=175173">](https://www.ellipsis.dev?ref=stack-auth%2Fstack-auth&utm_source=github&utm_medium=referral)<sup> for `3d20abc092`. You can [customize](https://app.ellipsis.dev/stack-auth/settings/summaries) this summary. It will automatically update as commits are pushed.</sup> ---- <!-- ELLIPSIS_HIDDEN --> <!-- This is an auto-generated comment: release notes by coderabbit.ai --> ## Summary by CodeRabbit * New Features * Added the ability for admins to view and update project configuration overrides through new internal API endpoints. * Extended the admin app to support fetching, updating, and caching configuration overrides, including React hook support for real-time config usage. * Introduced new admin interface methods for retrieving and updating configuration. * Bug Fixes * Improved validation and error handling for configuration updates, including checks for duplicate or invalid OAuth provider entries and non-existent configuration fields. * Tests * Added comprehensive end-to-end tests covering configuration retrieval, updates, access control, OAuth provider management, and domain management. * Documentation * Enhanced API documentation for configuration management endpoints and operations. <!-- end of auto-generated comment: release notes by coderabbit.ai --> --------- Co-authored-by: greptile-apps[bot] <165735046+greptile-apps[bot]@users.noreply.github.com> Co-authored-by: Konsti Wohlwend <n2d4xc@gmail.com>		2025-08-01 18:28:27 +02:00
..
scripts	Widget playground mobile mode	2025-07-14 20:04:43 -07:00
src	Config override CRUD (#803 )	2025-08-01 18:28:27 +02:00
.env	Vanilla JS client library (#408 )	2025-02-08 02:31:03 +01:00
.eslintrc.cjs	tsup for stack-shared (#647 )	2025-04-28 21:26:52 -07:00
.gitignore	Vanilla JS client library (#408 )	2025-02-08 02:31:03 +01:00
CHANGELOG.md	chore: update package versions	2025-07-30 10:50:54 -07:00
components.json	Vanilla JS client library (#408 )	2025-02-08 02:31:03 +01:00
LICENSE	Vanilla JS client library (#408 )	2025-02-08 02:31:03 +01:00
next-env.d.ts	Vanilla JS client library (#408 )	2025-02-08 02:31:03 +01:00
package-template.json	chore: update package versions	2025-07-30 10:50:54 -07:00
package.json	chore: update package versions	2025-07-30 10:50:54 -07:00
postcss.config.js	Vanilla JS client library (#408 )	2025-02-08 02:31:03 +01:00
quetzal.config.json	Vanilla JS client library (#408 )	2025-02-08 02:31:03 +01:00
README.md	Update branding from Stack to Stack Auth in documentation (#504 )	2025-03-04 04:07:54 +01:00
tailwind.config.js	Vanilla JS client library (#408 )	2025-02-08 02:31:03 +01:00
tsconfig.json	In-source unit tests (#429 )	2025-02-14 11:47:52 -08:00
tsup.config.ts	tsup for stack-shared (#647 )	2025-04-28 21:26:52 -07:00
vitest.config.ts	In-source unit tests (#429 )	2025-02-14 11:47:52 -08:00

README.md

Stack Auth: Open-source Clerk/Auth0 alternative

📘 Docs | ☁️ Hosted Version | ✨ Demo | 🎮 Discord | GitHub

Stack Auth is a managed user authentication solution. It is developer-friendly and fully open-source (licensed under MIT and AGPL).

Stack Auth gets you started in just five minutes, after which you'll be ready to use all of its features as you grow your project. Our managed service is completely optional and you can export your user data and self-host, for free, at any time.

We support Next.js frontends, along with any backend that can use our REST API. Check out our setup guide to get started.

📦 Installation & Setup

Run Stack Auth's installation wizard with the following command:
```
npx @stackframe/init-stack@latest
```
Then, create an account on the Stack Auth dashboard, create a new project with an API key, and copy its environment variables into the .env.local file of your Next.js project:
```
NEXT_PUBLIC_STACK_PROJECT_ID=<your-project-id>
NEXT_PUBLIC_STACK_PUBLISHABLE_CLIENT_KEY=<your-publishable-client-key>
STACK_SECRET_SERVER_KEY=<your-secret-server-key>
```
That's it! You can run your app with npm run dev and go to http://localhost:3000/handler/signup to see the sign-up page. You can also check out the account settings page at http://localhost:3000/handler/account-settings.

Check out the documentation for a more detailed guide.