managarten/apps-archived/bauntown/CLAUDE.md
Till-JS 61d181fbc2 chore: archive inactive projects to apps-archived/
Move inactive projects out of active workspace:
- bauntown (community website)
- maerchenzauber (AI story generation)
- memoro (voice memo app)
- news (news aggregation)
- nutriphi (nutrition tracking)
- reader (reading app)
- uload (URL shortener)
- wisekeep (AI wisdom extraction)

Update CLAUDE.md documentation:
- Add presi to active projects
- Document archived projects section
- Update workspace configuration

Archived apps can be re-activated by moving back to apps/

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude <noreply@anthropic.com>
2025-11-29 07:03:59 +01:00

124 lines
3.3 KiB
Markdown

# CLAUDE.md - BaunTown
This file provides guidance to Claude Code when working with the BaunTown project.
## Project Overview
BaunTown is a community website for developers and creators with:
- Multilingual support (DE, EN, IT)
- Payment integration (Stripe, PayPal)
- Content collections for news, projects, tutorials, etc.
- Netlify deployment with serverless functions
## Architecture
```
apps/bauntown/
├── apps/
│ └── landing/ # Astro landing page
│ ├── netlify/ # Serverless functions
│ ├── public/ # Static assets
│ ├── src/ # Source code
│ ├── astro.config.mjs
│ ├── netlify.toml
│ └── package.json # @bauntown/landing
├── packages/ # For future shared packages
├── readme/ # Documentation
├── package.json # Root orchestrator
└── CLAUDE.md # This file
```
## Quick Start
### Development
```bash
# From monorepo root
pnpm install
# Start BaunTown landing page
pnpm bauntown:dev
# Or directly
pnpm dev:bauntown:landing
```
### Build
```bash
# Build for production
pnpm --filter @bauntown/landing build
# Preview production build
pnpm --filter @bauntown/landing preview
```
## Environment Variables
Create `apps/bauntown/apps/landing/.env`:
```bash
STRIPE_SECRET_KEY=sk_...
STRIPE_WEBHOOK_SECRET=whsec_...
GOOGLE_SHEETS_CREDENTIALS=...
PUBLIC_STRIPE_KEY=pk_...
```
## Technology Stack
| Component | Technology |
| ---------- | --------------------------- |
| Framework | Astro 5.x |
| Styling | CSS/Tailwind |
| i18n | astro-i18n-aut (DE, EN, IT) |
| Payments | Stripe, PayPal |
| Analytics | Plausible (via Partytown) |
| APIs | Google Sheets/Docs |
| Deployment | Netlify (SSR + Functions) |
## Content Collections
BaunTown uses Astro Content Collections:
| Collection | Purpose |
| ---------- | --------------------------------------- |
| tools | Design, Development, Productivity tools |
| news | AI, Web, Design, Community news |
| models | AI models (Text, Image) |
| projects | Web, Mobile, Desktop projects |
| tutorials | Courses (UI/UX, Business, Marketing) |
| missions | Community challenges |
| vision | Long-term vision items |
| join | Join page content |
| members | Team members |
## Code Style Guidelines
- **TypeScript**: Strict mode (extends "astro/tsconfigs/strict")
- **Components**: Use `.astro` files, keep small and focused
- **Naming**: PascalCase for components, camelCase for variables
- **Formatting**: 2 spaces indentation
- **Imports**: Group by type (Astro, npm, local)
## URL Structure (i18n)
```
/de/ # German (default)
/en/ # English
/it/ # Italian
```
## Deployment
Deployed via Netlify with `@astrojs/netlify` adapter:
- Static pages pre-rendered
- Dynamic routes use Netlify Functions
- Configuration in `netlify.toml`
## Related Documentation
- `STRIPE-INTEGRATION-README.md` - Payment setup guide
- `readme/PlausibleCustomEventsReadMe.md` - Analytics setup
- `readme/PossibleNextSteps.md` - Future roadmap