soulcraft/brainy
2
0
Fork 0
Code Issues 1 Pull requests Projects Releases 335 Packages Wiki Activity Actions

**chore: remove outdated changelog and summary documents**

Browse source 
- Deleted `CHANGES.md`, `CHANGES_SUMMARY.md`, `CONCURRENCY_ANALYSIS.md`, `CONCURRENCY_IMPLEMENTATION_SUMMARY.md`, and related developer documentation files.
- Removed redundant or legacy content no longer aligned with the current codebase and workflows.
- Updated repository to reflect streamlined documentation approach, reducing clutter and improving maintainability.

**Purpose**: Simplify and declutter repository by removing obsolete documentation files, ensuring it remains focused and relevant.
This commit is contained in:
David Snelling 2025-07-30 11:51:39 -07:00
parent 0932e15274
commit d015d1a94d
30 changed files with 343 additions and 3 deletions
Download patch file Download diff file Expand all files Collapse all files

65
demo.md
View file

@ -1,65 +0,0 @@
# Running the Brainy Demo
The Brainy interactive demo showcases the library's features in a web browser. Follow these steps to run it:
## Prerequisites
- Make sure you have Node.js installed (version 24.4.0 or higher)
- Ensure the project is built (run both `npm run build` and `npm run build:browser`)
## Running the Demo
### Option 1: Using the npm script (recommended)
Run the following command from the project root:
```bash
npm run demo
```
This will start an HTTP server and automatically open the demo in your default browser.
### Option 2: Manual setup
1. Start an HTTP server in the project root:
```bash
npx http-server
```
2. Open your browser and navigate to:
http://localhost:8080/demo/index.html
## Troubleshooting
If you see the error "Could not load Brainy library. Please ensure the project is built and served over HTTP", check the
following:
1. Make sure you've built the project with `npm run build && npm run build:browser`
2. Ensure you're accessing the demo through HTTP (not by opening the file directly)
3. Check your browser's console for additional error messages
If issues persist, try clearing your browser cache or using a private/incognito window.
## Build Process
The Brainy library uses a two-step build process:
1. `npm run build` - Compiles TypeScript files to JavaScript (used for Node.js environments)
2. `npm run build:browser` - Creates a browser-compatible bundle using Rollup
You can run both steps together with:
```bash
npm run build && npm run build:browser
```
Or simply use the demo script which does this for you:
```bash
npm run demo
```
The browser bundle is created from `src/unified.ts`, which provides environment detection and adapts to browser,
Node.js, or serverless environments. This unified approach ensures that the library works correctly across all
environments.