mirror of
https://github.com/anomalyco/opencode.git
synced 2026-11-17 05:26:47 +03:00
61 lines
2.6 KiB
Markdown
61 lines
2.6 KiB
Markdown
# SolidStart
|
|
|
|
Everything you need to build a Solid project, powered by [`solid-start`](https://start.solidjs.com);
|
|
|
|
## Creating a project
|
|
|
|
```bash
|
|
# create a new project in the current directory
|
|
npm init solid@latest
|
|
|
|
# create a new project in my-app
|
|
npm init solid@latest my-app
|
|
```
|
|
|
|
## Developing
|
|
|
|
Once you've created a project and installed dependencies with `npm install` (or `pnpm install` or `yarn`), start a development server:
|
|
|
|
```bash
|
|
npm run dev
|
|
|
|
# or start the server and open the app in a new browser tab
|
|
npm run dev -- --open
|
|
```
|
|
|
|
### GitHub API
|
|
|
|
The Worker holds no GitHub token. Stars, contributors and avatars come from the build-time snapshot
|
|
(`script/github-snapshot.ts`, `src/lib/github-snapshot.json`). The changelog reads releases from the
|
|
GitHub API without a token (`src/lib/changelog.ts`, `src/lib/github-api.ts`), cached for 15 minutes in
|
|
memory and at the edge, with the snapshot as fallback. Without a token GitHub allows 60 calls an hour
|
|
per IP; in dev the last good releases are kept in `$TMPDIR/opencode-site-github/`, so a restart while
|
|
rate limited still has them. The snapshot script uses `GITHUB_TOKEN` when it is set (CI passes the
|
|
workflow's own token):
|
|
|
|
```bash
|
|
GITHUB_TOKEN=$(gh auth token) bun ./script/github-snapshot.ts
|
|
```
|
|
|
|
Never commit a token.
|
|
|
|
## Building and deploying
|
|
|
|
`bun run build -- --mode dev` builds the site (Nitro's `cloudflare-module` preset) into the Build Output
|
|
Specification tree in `.cloudflare/output`; `bun run deploy:dev` builds and runs
|
|
`cf deploy --prebuilt --mode dev`. `cloudflare.config.ts` defines the Worker (`opencode-site-dev` on
|
|
dev.opencode.ai, `opencode-site-production` on opencode.ai), its bindings and its routes. CI deploys on
|
|
pushes to `dev` and `production` (`.github/workflows/deploy-site.yml`). Production takes no routes until
|
|
`productionOwnsRoot` is switched on.
|
|
|
|
Each build also carries the hashed scripts and stylesheets of the last 20 builds it replaces (for up to a
|
|
week), downloaded from the live site's `/_build/retained.json`, so pages already open keep loading their
|
|
code after a deploy (`script/retain-assets.ts`). A rollback in the Cloudflare dashboard restores the older
|
|
version's assets only, so tabs opened on the rolled-back build reload once.
|
|
|
|
The V2 docs at `/docs` and the V1 docs at `/v1/docs` are part of this app (`src/docs/`, see `src/docs/AGENTS.md`).
|
|
`script/build.ts` prerenders them into the Worker's assets after `vite build`. A `/docs` URL without a V2 page
|
|
redirects to the same path on the V1 docs.
|
|
|
|
## This project was created with the [Solid CLI](https://github.com/solidjs-community/solid-cli)
|