For AI agents: fetch the complete documentation index at /llms.txt, the full documentation corpus at /llms-full.txt, the agent skill at /skill.md, or this page as Markdown at /nl/docs/web/feature-flags.md (or send Accept: text/markdown).
Feature flags en aankondigingen
Ship in het donker, gate per workspace en broadcast naar leden.
Walkthrough voor beginners
Vereisten: Lees de twee onderstaande beginnershandleidingen, voltooi de lokale webconfiguratie en open deze monorepo in de root van uw editor. Webinstellingen horen thuis in apps/web/.env.local; Next.js leest de root .env niet. /dashboard in de standaard nepmodus is een demo zonder database; /auth heeft een gemigreerde database nodig.
Korte termen: een werkruimte bestaat uit de afzonderlijke gebruikers, gegevens en instellingen van één team. De server is de vertrouwde backend; houd providersleutels uit de browser- en telefooncode. Een migratie is een versiebeheer van de database, waarbij tabellen worden gemaakt of bijgewerkt. Een AI-model is de motor die antwoord geeft; de modelcatalogus is de serverlijst met beschikbare model-ID's en prijzen. Een provider is een externe service, zoals een AI-, e-mail- of factureringsservice. Een recht is een subsidie waarmee een werkruimte een functie kan gebruiken. Een webhook is een bericht dat de ene service naar de URL van een andere service verzendt.
1. Meld u aan als platformbeheerder en open /admin/flags; maak of selecteer één testvlag en stel deze expliciet in op ingeschakeld en vervolgens op uitgeschakeld.
2. Vernieuw het productoppervlak waarop de vlag staat en bevestig de presentatiewijzigingen.
3. Rollen en rechten moeten nog steeds serveracties beschermen wanneer een vlag is ingeschakeld. Als de API toegankelijk blijft terwijl deze is uitgeschakeld, voeg dan waar bedoeld een vlagcontrole aan de serverzijde toe.
Voor aangepaste code begint u met de meegeleverde prompts/README.md en kopieert u de dichtstbijzijnde prompt: prompts/new-app-screen.md voor een app-scherm of prompts/new-landing-page.md voor een openbare pagina. Voor server-, database- of providerwerk geeft u uw codeeragent de taak van deze handleiding en vraagt u hem om AGENTS.md, .ai/PROJECT_CONTEXT.md en overeenkomende .ai/-mirrors te lezen; inspecteer de exacte bronbestanden die hier worden genoemd; maak een lijst van bestanden en controleer deze voordat u deze bewerkt; behoud van het eigendom van de werkruimte en geheimen voor de server; en laat je het verschil zien. Vertel het gewenste gedrag, invoer- en uitvoervelden, toegestane rollen, verwacht succes en fouten, en het testaccount, de provider of het apparaat. Gebruik voorbeeldwaarden; plak nooit een echt geheim.
Configureer vlaggen in Beheerder
/admin/flags en feature-flags.ts bieden het vlagbeheer-/evaluatiepad van de kit. De vlagconfiguratie is eigendom van de platformbeheerder; een product-UI kan reageren op een toegestane functie zonder de bevoegdheid te verkrijgen om de vlag te wijzigen.
Controleer ingeschakeld en uitgeschakeld gedrag
Test standaardwaarden, ontbrekende vlaggen, updates, rolweigering en vlaggestuurde serveracties. Behoud toegangscontroles voor de werkruimte bij het toevoegen van uitrollogica.
Setup en configuratie
feature-flag-runtime resolvt flags voor een caller-context: niet-geconfigureerde flags staan standaard uit en per-flag overrides richten zich op specifieke workspaces of gebruikers. Een ontbrekende flag kan nooit stilletjes een oppervlak inschakelen.
Platformaankondigingen (announcement-actions) zenden in-app meldingen uit via hetzelfde notificatieoppervlak dat leden al lezen — listActiveAnnouncements voedt de banner, dismissAnnouncementAction legt het wegklikken vast.
await isFeatureEnabled(flag, { workspaceId })
await resolveFeatureFlags(context)
listActiveAnnouncements()
dismissAnnouncementAction(formData)Implementatieworkflow
Ship code in het donker: merge achter een flag, zet hem aan voor je eigen workspace en verbreder daarna. Verwijder de flag zodra het oppervlak permanent is — een verouderde flag is een tweede bron van waarheid.
Check de flag op de servergrens ÉN in de navigatie: een verborgen link met een open route is geen gated feature. Houd aankondigingen van het transactionele mailpad — het is productnieuws, geen bonnen.
Verificatie en probleemoplossing
Verifieer dat een uitgeschakelde flag nav, route en actie end-to-end verbergt; dat een override alleen voor zijn target resolvt; en dat een gewiste flag terugvalt op de default. Test dat aankondigingsbezorging de bedoelde workspaces bereikt en dat wegklikken persisteert.