How swajithanand/ai-artifact-generator works
AI Artifact Generator turns a business use case into Agile artifacts through a React UI, a FastAPI generation flow, and optional persistence. Users configure a BYOK provider, submit context and artifact type, receive structured output for Markdown display, and can revisit history. The documented product also includes provider-key validation, artifact-specific Epic/Feature/User Story prompts, and browser-only key storage. Backend route details are excerpted only in part; history and provider-to-vendor links are documented in the README, so those edges cite it.
Main entry points: main.py API routes · ArtifactGenerator.tsx Artifact workspace · strategies.py Provider factory · SettingsModal.tsx Provider settings
Components 18
Browser experience
- App shell
App.tsx - Artifact workspace
components/ArtifactGenerator.tsx - Provider settings
components/SettingsModal.tsx - Browser key storage
llmSettings.ts - API endpoint config
config.ts - Markdown result
components/ArtifactGenerator.tsx
Generation backend
- API routes
main.py - Artifact models
models.py - Prompt router
prompts.py - Artifact parser
main.py
LLM providers
- Provider factory
strategies.py - Gemini
- OpenAI
- Anthropic
Artifact history
- Persistence service
main.py - History database
database.py - Supabase Postgres
Other components
- User
Connections 23
- User → App shell: opens app
README.md - App shell → Artifact workspace: renders
App.tsx - User → Provider settings: configures provider
README.md - Provider settings → Browser key storage: saves settings
components/SettingsModal.tsx - Artifact workspace → Browser key storage: loads settings
components/ArtifactGenerator.tsx - Provider settings → API routes: tests key
components/SettingsModal.tsx - Artifact workspace → API routes: submits request
components/ArtifactGenerator.tsx - Artifact workspace → API endpoint config: uses endpoint
components/ArtifactGenerator.tsx - API routes → Provider factory: builds provider
main.py - API routes → Artifact models: accepts models
main.py - Provider factory → Prompt router: constructs prompt
strategies.py - API routes → Prompt router: validates prompt
main.py - Provider factory → Gemini: calls API
README.md - Provider factory → OpenAI: calls API
README.md - Provider factory → Anthropic: calls API
README.md - Provider factory → API routes: returns raw text
README.md - API routes → Artifact parser: parses output
README.md - API routes → Persistence service: saves artifact
main.py - Persistence service → History database: uses session
main.py - History database → Supabase Postgres: stores history
README.md - API routes → Artifact workspace: returns artifact
README.md - Artifact workspace → Markdown result: renders markdown
components/ArtifactGenerator.tsx - Artifact workspace → API routes: fetches history
README.md