https://github.com/adsabs/bumblebee
🐝 Clever face for ADS
https://github.com/adsabs/bumblebee
astrophysics database website
Last synced: 5 months ago
JSON representation
🐝 Clever face for ADS
- Host: GitHub
- URL: https://github.com/adsabs/bumblebee
- Owner: adsabs
- License: gpl-2.0
- Created: 2014-02-22T00:59:37.000Z (over 12 years ago)
- Default Branch: master
- Last Pushed: 2026-01-15T18:27:58.000Z (5 months ago)
- Last Synced: 2026-01-15T20:51:51.603Z (5 months ago)
- Topics: astrophysics, database, website
- Language: JavaScript
- Homepage: https://ui.adsabs.harvard.edu
- Size: 47 MB
- Stars: 38
- Watchers: 17
- Forks: 22
- Open Issues: 209
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGES.txt
- License: LICENSE
Awesome Lists containing this project
README
[](https://travis-ci.org/adsabs/bumblebee) [](https://coveralls.io/github/adsabs/bumblebee)
## bumblebee
Official web application built for the [Astrophysics Data System](https://ui.adsabs.harvard.edu) and its API.
### Development
You will need to have Docker installed to run the development server. [Get Docker](https://docs.docker.com/get-docker/)
#### Installation
```bash
# fork and/or clone repo
$ git clone git@github.com:adsabs/bumblebee.git
# initialize submodule
$ git submodule update --init
# install assets
$ npm install -g grunt-cli
$ npm install
# start the server
$ npm run dev
```
You should then be able to access the application locally at `http://localhost:8000`.
#### Configuration
Create a `src/config/discovery.vars.js` file, based on `discovery.vars.js.default`.
#### Building
```bash
$ npm run release
# full build will be in dist/ directory
# point the dev server to there:
$ npm start
```
### Testing
**Note!** There is a separate server for testing, you'll need to first stop the dev server then start the testing server: `grunt server`.
During testing, you can add `debugger` statements and use mocha's `only` to isolate a test when running in debug mode.
```bash
# Run everything
$ npm run test
# Run with puppeteer window open
$ npm run test:debug
```
### Documentation
- [How to write a widget](https://github.com/adsabs/bumblebee/blob/master/docs/how-to-write-widget.md)
- [Architecture Overview](https://github.com/adsabs/bumblebee/blob/master/docs/architecture.md)
- [Explanation of the Search Cycle](https://github.com/adsabs/bumblebee/blob/master/docs/search-cycle.md)