feat: bootstrap vela UI and gateway workspace

Establish the monorepo, tooling, and starter apps so UI and gateway development can begin from a documented, runnable baseline.
This commit is contained in:
2026-04-08 17:49:46 +02:00
commit bba0095bc0
23 changed files with 2023 additions and 0 deletions

33
README.md Normal file
View File

@@ -0,0 +1,33 @@
# Vela
Vela is a local-first, voice-first assistant designed around a browser PWA, a gateway service, and self-hosted integrations for speech, LLM orchestration, home automation, search, and speech synthesis.
## Documentation
- [Project overview](docs/overview.md)
- [Architecture](docs/architecture.md)
- [Event protocol and state machine](docs/protocol.md)
- [Integrations and tool safety](docs/integrations.md)
- [Deployment and operations](docs/deployment.md)
- [Setup and workspace usage](docs/setup.md)
- [Phased backlog](docs/backlog.md)
- [README migration map](docs/readme-migration-map.md)
## Development
- Use **mise** for tooling in this repository.
- Use **Yarn** as the package manager once provisioned by mise.
- Bootstrap tools with `mise install`.
- Run repo commands with `mise exec -- yarn …` if your shell is not activated for mise.
- Install workspace dependencies with `mise exec -- yarn install`.
- Start the SvelteKit UI with `mise exec -- yarn dev:ui`.
- Start the Fastify gateway with `mise exec -- yarn dev:gateway`.
- Build the UI with `mise exec -- yarn build:ui` and run the UI check with `mise exec -- yarn check:ui`.
## Working Agreement
- [AGENTS.md](AGENTS.md) defines how implementation work and documentation should stay aligned.
## Status
The repository now includes a minimal runnable SvelteKit UI and a minimal runnable Fastify gateway as the baseline for the next vertical slices.