npm install --save coveo-search-ui
All resources will be available under
node_modules/coveo-search-ui/bin. You can include those in your pages with
<script> tags. This will make the variable
Coveo globally available in your page.
If you are using a module bundler (Browserify, Webpack, rollup, etc.), you can use
import * as Coveo from 'coveo-search-ui'.
Including the Resources from a CDN
official release (from version
1.2537 on) through a content delivery network (CDN).
You can simply use a URL such as
https://static.cloud.coveo.com/searchui/v[VERSION]/[PATH_TO_FILE], where you
[VERSION] by the actual release version number you wish to use and
[PATH_TO_FILE] by the path of the file
The following tags include the
1.2537version (April 2017 release) of the
<head> [ ... ] <script src="https://static.cloud.coveo.com/searchui/v1.2537/js/CoveoJsSearch.min.js"></script> <script src="https://static.cloud.coveo.com/searchui/v1.2537/js/templates/templatesNew.js"></script> <link rel="stylesheet" href="https://static.cloud.coveo.com/searchui/v1.2537/css/CoveoFullSearchNewDesign.css" /> [ ... ] </head>
<!-- Include the library scripts. --> <script src="js/CoveoJsSearch.js"></script> <script src="js/templates/templates.js"></script> <!-- Each DOM element with a class starting with "Coveo" (uppercase) will instantiate a component. --> <body id="search" class='CoveoSearchInterface'> <!-- Each DOM element with a class starting with "coveo-" (lowercase) is strictly for CSS/alignment purpose. --> <div class='coveo-search-section'> <!-- Any Coveo component can be removed (or added); none is actually required for the page to "load". --> <div class="CoveoSearchbox"></div> </div> <!-- The "data-" attributes of each component allow you to pass options to this specific component instance. --> <div class="CoveoFacet" data-title="Author" data-field="@author" data-tab="All"></div> <div class="CoveoFacet" data-title="Year" data-field="@year" data-tab="All"></div> <script> // The following line shows you how you could configure an endpoint against which to perform your search. // Coveo.SearchEndpoint.configureCloudEndpoint('MyCoveoCloudEnpointName', 'my-authentification-token'); // We provide a sample endpoint with public sources for demo purposes. Coveo.SearchEndpoint.configureSampleEndpoint(); // Initialize the framework by targeting the root in the interface. // It does not have to be the document body. Coveo.init(document.body); </script> </body>
You can find more examples of fully configured pages in the
You should have node 10.x installed to build this project.
npm install -g yarn yarn global add gulp yarn install gulp
Important Gulp Tasks
gulp default: Builds the entire project (CSS, templates, TypeScript, etc.)
gulp compile: Builds only the TypeScript code and generates its output in the
gulp unitTests: Builds and runs the unit tests.
gulp doc: Generates the documentation website for the project.
gulp dev: Starts a webpack dev server for the project.
gulp devTest: Starts a webpack dev server for the unit tests.
Make sure you were able to run
gulp entirely without any errors first. Then you can start the dev-server:
This will start a webpack-dev-server instance (see Webpack Dev Server).
You can now load http://localhost:8080/index.html in a web browser.
Any time you hit Save in a source file, the bundle will be recompiled and the dev page will reload.
If you need to modify the content of the search page (i.e., the markup itself, not the TypeScript code), modify the
index.html page under
./bin. This page is not committed to the repository, so you do not have to worry about
breaking anything. However, if you feel like you have a good reason to modify the original
index.html, feel free to
You might need to assign more memory to Webpack if you see errors about
heap out of memory. To do so, use this command :
node --max_old_space_size=8192 ./node_modules/gulp/bin/gulp.js dev;
Tests are written using Jasmine. You can use
npm run test to run
the tests in Chrome Headless.
If you wish to write new unit tests, you can do so by starting a new webpack-dev-server instance.
To start the server, run
Every time you hit Save in a source file, the dev server will reload and re-run your tests.
Code coverage will be reported in
You can also use Coveo Search to find answers to any specific issues/questions (see the Coveo Community Portal).
Issues and questions
Please use the Coveo community to ask questions or to search for existing solutions.