boostio / boost-releases

🚀 Boostnote app releases & changelog

TachiJS

Tachi(太刀) https://en.wikipedia.org/wiki/Tachi

Highly testable dead simple web server written in Typescript

• 🏁 Highly testable. (all props in req and res are injectable so you don't have to mock at all.)
• 🔧 Highly customizable.
• 💉 Simple dependency injection.
• ⚡ async/await request handler. (like Koa without any configurations.)
• 🏭 Based on expressjs. (You can benefit from using this mature library)
• ✅ Built-in request body validator.
• 📐 Written in Typescript.

Why?

Nest.js looks nice. But its learning curve is too stiff.(TBH, I still don't know how to redirect dynamically.) Most of people probably do not need to know how Interceptor, Pipe and other things work. It might be good for some enterprize level projects.

But using raw expressjs is also quite painful. To test express apps, you have to use supertest or chai-http things. If you use them, you will lose debugging and error stack while testing because they send actual http request internally. Otherwise, you have to mock up all params, req, res and next, of RequestHandler of express.js.

To deal with the testing problem, inversify-express-utils could be a solution. But it does not support many decorators. To render with view engine like pug, we need to use res.render method. But the only solution is using @response decorator. It means you have to mock up Response in your test. So technically it is super hard to test routes rendering view engine.

Luckily, TachiJS tackles those problems. If you have other ideas, please create an issue!!

How to use

Install tachijs

npm i tachijs reflect-metadata

Add two compiler options, experimentalDecorators and emitDecoratorMetadata, to tsconfig.json.

{
  "compilerOptions": {
    ...
    "experimentalDecorators": true,
    "emitDecoratorMetadata": true,
    ...
  }
}

Quick start

import tachijs, { controller, httpGet } from 'tachijs'

@controller('/')
class HomeController() {
  // Define when this method should be used.
  @httpGet('/')
  index() {
    return {
      message: 'Hello, world!'
    }
  }
}

// Register `HomeController`
const app = tachijs({
  controllers: [HomeController]
})

// `app` is just an express application instance
app.listen(8000)

Now you can access http://localhost:8000/.

For other http methods, tachijs provides @httpPost, @httpPut, @httpPatch, @httpDelete, @httpOptions, @httpHead and @httpAll.

Configuring express app(Middlewares)

There are lots of ways to implement express middlewares.

Use before and after options

import bodyParser from 'body-parser'
import { ConfigSetter, NotFoundException } from 'tachijs'

const before: ConfigSetter = app => {
  app.use(bodyParser())
}

const after: ConfigSetter = app => {
  app.use('*', (req, res, next) => {
    next(new NotFoundException('Page does not exist.'))
  })

  const errorHandler: ErrorRequestHandler = (error, req, res, next) => {
    const { status = 500, message } = error
    res.status(status).json({
      status,
      message
    })
  }
  app.use(errorHandler)
}

const app = tachijs({
  before,
  after
})

app.listen(8000)

Without before or after options

Identically same to the above example.

import express from 'express'
import bodyParser from 'body-parser'
import { ConfigSetter, NotFoundException } from 'tachijs'

const app = express()
app.use(bodyParser())

tachijs({
  app
})

app.use('*', (req, res, next) => {
  next(new NotFoundException('Page does not exist.'))
})

const errorHandler: ErrorRequestHandler = (error, req, res, next) => {
  const { status = 500, message } = error
  res.status(status).json({
    status,
    message
  })
}
app.use(errorHandler)

app.listen(8000)

Apply middlewares to controllers and methods

Sometimes, you might want to apply middlewares to several methods only.

import { controller, httpGet, ForbiddenException } from 'tachijs'
import cors from 'cors'
import { RequestHandler } from 'express'

const onlyAdmin: RequestHandler = (req, res, next) => {
  if (!req.user.admin) {
    next(new ForbiddenException('Only admin users can access this api'))
    return
  }
  next()
}

// Apply `cors()` to controller. Now all methods will use the middleware.
@controller('/', [cors()])
class HomeController() {
  @httpGet('/')
  index() {
    return {
      message: 'Hello, world!'
    }
  }

  // Apply `onlyAdmin` to `admin` method. This middleware will be applied to this method only.
  @httpGet('/', [onlyAdmin])
  admin() {
    return {
      message: 'Hello, world!'
    }
  }
}

Configure router options

Tachijs will create and register a router for each controller.

So you can provide router options via @controller decorator.

@controller('/:name', [], {
  // Provide mergeParams option to express router.
  mergeParams: true
})
class HomeController {
  @httpGet('/hello')
  // Now routes in the controller can access params.
  index(@reqParams('name') name: string) {
    return `Hello, ${name}`
  }
}

Access req.params, req.query and req.body via decorators

You can access them via @reqParams, @reqQuery and @reqBody. (Don't forget to apply body-parser middleware)

import {
  controller,
  httpGet,
  httpPost,
  reqParams,
  reqQuery,
  reqBody
} from 'tachijs'

@controller('/posts')
class PostController() {
  @httpGet('/:postId')
  // `req.params.postId`
  async show(@reqParams('postId') postId: string) {
    const post = await Post.findById(postId)

    return {
      post
    }
  }

  @httpGet('/search')
  // `req.query.title`
  async search(@reqQuery('title') title: string = '') {
    const posts = await Post.find({
      title
    })

    return {
      posts
    }
  }

  @httpPost('/')
  // `req.body` (`@reqBody` does not accept property keys.)
  async create(@reqBody() body: unknown) {
    const validatedBody = validate(body)
    const post = await Post.create({
      ...validatedBody
    })

    return {
      post
    }
  }
}

We also provide reqHeaders, reqCookies and reqSession for req.headers, req.cookies and req.session. To know more, see our api documentation below.

Body validation

@reqBody supports validation via class-validator.

Please install class-validator package first.

npm install class-validator

import { IsString } from 'class-validator'

class PostDTO {
  @IsString()
  title: string

  @IsString()
  content: string
}


@controller('/posts')
class PostController() {
  @httpPost('/')
  // Tachijs can access `PostDTO` via reflect-metadata.
  async create(@reqBody() body: PostDTO) {
    // `body` is already validated and transformed into an instance of `PostDTO`.
    // So we don't need any extra validation.
    const post = await Post.create({
      ...body
    })

    return {
      post
    }
  }
}

Custom parameter decorators!

If you're using passport, you should want to access user data from req.user. @handlerParam decorator make it possible. The decorator gets a selector which accepts express's req, res and next. So all you need to do is decide what to return from thoes three parameters.

import { controller, httpGet, handlerParam } from 'tachijs'

@controller('/')
class HomeController {
  @httpGet('/')
  async showId(@handlerParam((req, res, next) => req.user) user: any) {
    doSomethingWithUser(user)

    return {
      ...
    }
  }
}

If you want reusable code, please try like the below.

import { controller, httpGet, handlerParam } from 'tachijs'

function reqUser() {
  // You can omit other next params, `res` and `next`, if you don't need for your selector.
  return handlerParam(req => req.user)
}

@controller('/')
class HomeController {
  @httpGet('/')
  async showId(@reqUser() user: any) {
    doSomethingWithUser(user)

    return {
      ...
    }
  }
}

Bind methods of req or res before exposing

You can also pass methods of req or res which are augmented by express module. Some of them might need the context of them. So please bind methods before exposing like the below example.

export function cookieSetter() {
  return handlerParam((req, res) => res.cookie.bind(res))
}

design:paramtype

Moreover, tachijs exposes metadata of parameters to forth argument. So you can make your custom validator for query with class-transformer-validator like below. (req.body is also using this.)

import { controller, httpGet, handlerParam } from 'tachijs'
import { IsString } from 'class-validator'
import { transformAndValidate } from 'class-transformer-validator'

function validatedQuery() {
  return handlerParam((req, res, next, meta) => {
    // meta.paramType is from `design:paramtypes`.
    // It is `Object` if the param type is unknown or any.
    return meta.paramType !== Object
      ? transformAndValidate(meta.paramType, req.query)
      : req.query
  })
}

// Validator class
class SearchQuery {
  @IsString()
  title: string
}

@controller('/')
class PostController {
  @httpGet('/search')
  // Provide the validator class to param type.
  // tachijs can access it via `reflect-metadata`.
  search(@validatedQuery() query: SearchQuery) {
    // Now `query` is type-safe
    // because it has been validated and transformed into an instance of SearchQuery.
    const { title } = query

    return {
      ...
    }
  }
}

To know more, see @handlerParam api documentation below.

Redirection, Rendering via pug and others...

Techinically, you don't have to access res to response data. But, if you want to redirect or render page via pug, you need to access res.redirect or res.render. Sadly, if you do, you have make mockup for res.

But, with tachijs, you can tackle this problem.

import { controller, httpGet, RedirectResult } from 'tachijs'

@controller('/')
class HomeController {
  @httpGet('/redirect')
  redirectToHome() {
    return new RedirectResult('/')
  }
}

Now, you can test your controller like the below example.

describe('HomeController#redirectToHome', () => {
  it('redirects to `/`', async () => {
    // Given
    const controller = new HomeController()

    // When
    const result = controller.redirectToHome()

    // Then
    expect(result).toBeInstanceOf(RedirectResult)
    expect(result).toMatchObject({
      location: '/'
    })
  })
})

There are other results too, EndResult, JSONResult, RenderResult, SendFileResult, SendResult, and SendStatusResult. Please see our api documentation below.

BaseController

If you need to use many types of result, you probably want BaseController. Just import it once, and your controller can instantiate results easily.

import { controller, httpGet, BaseController } from 'tachijs'

@controller('/')
// You have to extend your controller from `BaseController`
class HomeController extends BaseController {
  @httpGet('/redirect')
  redirectToHome() {
    // This is identically same to `return new RedirectResult('/')`
    return this.redirect('/')
  }
}

BaseController has methods for all build-in results, Please see our api documentation below.

BaseController#context

You may want to share some common methods via your own base controller. But, sadly, it is not possible to use decorators to get objects from req or res and services provided by @inject.

To make it possible, we introduce context. Which expose req, res and inject method via context if your controller is extended from BaseController.

interface Context {
  req: express.Request
  res: express.Response
  inject<S>(key: string): S
}

import { BaseController, controller, httpPost } from 'tachijs'

class MyBaseController extends BaseController {
  async getUserConfig() {
    // When unit testing, `context` is not defined.
    if (this.context == null) {
      return new UserConfig()
    }

    const { req, inject } = this.context

    // Now we can get the current user from `req`
    const currentUser = req.user

    // And inject any services from the container.
    const userConfigService = inject<UserConfigService>(
      ServiceTypes.UserConfigService
    )

    return userConfigService.findByUserId(userId)
  }
}

@controller('/')
class HomeController {
  @httpGet('/settings')
  settings() {
    const userConfig = await this.getUserConfig()

    return this.render('settings', {
      userConfig
    })
  }
}

#httpContext, #inject and #injector will be deprecated from v1.0.0. Please use #context

Customize result

If you want to have customized result behavior, you can do it with BaseResult. BaseResult is an abstract class which coerce you to define how to end the route by providing execute method. (Every built-in result is extended from BaseResult.)

Let's see our implementation of RedirectResult.

import express from 'express'
import { BaseResult } from './BaseResult'

export class RedirectResult extends BaseResult {
  constructor(
    public readonly location: string,
    public readonly status?: number
  ) {
    super()
  }

  // tachijs will provide all what you need and execute this method.
  async execute(
    req: express.Request,
    res: express.Response,
    next: express.NextFunction
  ) {
    if (this.status != null) return res.redirect(this.status, this.location)
    return res.redirect(this.location)
  }
}

Dependency injection

To make controllers more testable, tachijs provides dependency injection.

Let's think we have some mailing service, MailerService. While developing or testing, we probably don't want our server to send real e-mail everytime.

import tachijs, {
  controller,
  httpGet,
  httpPost,
  reqBody,
  inject,
  BaseController
} from 'tachijs'

// Create enum for service types
enum ServiceTypes {
  EmailService = 'EmailService',
  NotificationService = 'NotificationService'
}

// Abstract class coerce MailerService must have `sendEmail` method.
abstract class MailerService {
  abstract sendEmail(content: string): Promise<void>
}

// Mockup service for development and testing.
class MockEmailService extends MailerService {
  async sendEmail(content: string) {
    console.log(`Not sending email.... content: ${content}`)
  }
}

class EmailService extends MailerService {
  async sendEmail(content: string) {
    console.log(`Sending email.... content: ${content}`)
  }
}

interface Container {
  [ServiceTypes.EmailService]: typeof MailerService
}

const envIsDev = process.env.NODE_ENV === 'development'

// Swapping container depends on the current environment.
const container: Container = envIsDev
  ? {
      // In development env, don't send real e-mail because we use mockup.
      [ServiceTypes.EmailService]: MockEmailService
    }
  : {
      [ServiceTypes.EmailService]: EmailService
    }

@controller('/')
class HomeController extends BaseController {
  constructor(
    // Inject MailerService. The controller will get the one registered to the current container.
    @inject(ServiceTypes.EmailService) private mailer: MailerService
  ) {
    super()
  }

  @httpGet('/')
  home() {
    return `<form action='/notify' method='post'><input type='text' name='message'><button>Notify</button></form>`
  }

  @httpPost('/email')
  async sendEmail(@reqBody() body: any) {
    await this.mailer.sendEmail(body.message)

    return this.redirect('/')
  }
}

const server = tachijs({
  controllers: [HomeController],
  // Register container
  container
})

So you can test HomeController#sendEmail like the below example.

describe('HomeController#sendEmail', () => {
  it('sends email', async () => {
    // Given
    const spyFn = jest.fn()
    class TestEmailService extends MailerService {
      async sendEmail(content: string): Promise<void> {
        spyFn(content)
      }
    }
    const controller = new HomeController(new TestEmailService())

    // When
    const result = controller.sendEmail('hello')

    // Then
    expect(spyFn).toBeCalledWith('hello')
  })
})

Now we don't have to worry that our controller sending e-mail for each testing.

Furthermore, you can inject other services to your service as long as they exist in the container.

class NotificationService {
  constructor(
    // When NotificationService is instantiated, MailerService will be instantiated also by tachijs.
    @inject(ServiceTypes.EmailService) private mailer: MailerService
  ) {}

  async notifyWelcome() {
    await this.mailer.sendEmail('Welcome!')
  }
}

DI without tachijs

When some testing or just writing scripts using services, you might want to use DI without tachijs function. So we exposed Injector class which is used by tachijs.

enum ServiceTypes {
  NameService = 'NameService',
  MyService = 'MyService'
}
class NameService {
  getName() {
    return 'Test'
  }
}
class MyService {
  constructor(
    @inject(ServiceTypes.NameService) private nameService: NameService
  ) {}

  sayHello() {
    return `Hello, ${this.nameService.getName()}`
  }
}
const container = {
  [ServiceTypes.NameService]: NameService,
  [ServiceTypes.MyService]: MyService
}

// Create injector
const injector = new Injector(container)

// Instantiate by a key
const myService = injector.inject<MyService>(ServiceTypes.MyService)
// Instantiate by a constructor
const myService = injector.instantiate(MyService)

Bad practices

Please check this section too to keep your controllers testable.

Execute res.send or next inside of controllers or @handlerParam

Please don't do that. It just make your controller untestable. If you want some special behaviors after your methods are executed, please try to implement them with BaseResult.

Do

class HelloResult extends BaseResult {
  async execute(
    req: express.Request,
    res: express.Response,
    next: express.NextFunction
  ) {
    res.send('Hello')
  }
}

class HomePageController extends BaseController {
  @httpGet('/')
  index() {
    // Now we can test it by just checking the method returns an instance of `HelloResult`.
    return new HelloResult()
  }
}

Don't

class HomePageController {
  @httpGet('/')
  index(@handlerParam((req, res) => res) res: expressResponse) {
    // We have to make mock-up for express.Response to test
    res.send('Hello')
  }
}

Access BaseController#context in your descendant controllers

It is designed to be used inside of your base controller to make unit testing easy.

Do

class MyBaseController extends BaseController {
  doSomethingWithContext() {
    if (this.context == null) {
      // on unit testing
      return
    }
    // on live
  }
}

Don't

class HomePageController extends MyBaseController {
  @httpGet('/')
  index() {
    // We have to make mock-up everything to test
    this.context!.req....
  }
}

APIs

tachijs(options: TachiJSOptions): express.Application

Create and configure an express app.

TachiJSOptions

interface TachiJSOptions<C = {}> {
  app?: express.Application
  before?: ConfigSetter
  after?: ConfigSetter
  controllers?: any[]
  container?: C
}

type ConfigSetter = (app: express.Application) => void

• app Optional. If you provide this option, tachijs will use it rather than creating new one.
• before Optional. You can configure express app before registering controllers for applying middlewares.
• after Optional. You can configure express app before registering controllers for error handling.
• controllers Optional. Array of controller classes.
• container Optional. A place for registered services. If you want to use DI, you have to register services to here first.

@controller(path: string, middlewares: RequestHandler[] = [], routerOptions: RouterOptions = {})

It marks class as a controller.

• path Target path.
• middlewares Optional. Array of middlewares.
• routerOptions Optional. Express router options.

@httpMethod(method: string, path: string, middlewares: RequestHandler[] = [])

It marks method as a request handler.

• method Target http methods, 'get', 'post', 'put', 'patch', 'delete', 'options', 'head' or 'all' are available. ('all' means any methods.)
• path Target path.
• middlewares Optional. Array of middlewares.

tachijs also provides shortcuts for @httpMethod.

• @httpGet(path: string, middlewares: RequestHandler[] = [])
• @httpPost(path: string, middlewares: RequestHandler[] = [])
• @httpPut(path: string, middlewares: RequestHandler[] = [])
• @httpPatch(path: string, middlewares: RequestHandler[] = [])
• @httpDelete(path: string, middlewares: RequestHandler[] = [])
• @httpOptions(path: string, middlewares: RequestHandler[] = [])
• @httpHead(path: string, middlewares: RequestHandler[] = [])
• @httpAll(path: string, middlewares: RequestHandler[] = [])

@handlerParam<T>(selector: HandlerParamSelector<T>)

• selector selects a property from req, res, next or even our meta

export type HandlerParamSelector<T> = (
  req: express.Request,
  res: express.Response,
  next: express.NextFunction,
  meta: HandlerParamMeta<T>
) => T

interface HandlerParamMeta<T> {
  index: number
  selector: HandlerParamSelector<T>
  paramType: any
}

• index Number index of the parameter.
• selector Its selector.
• paramType metadata from design:paramtypes.

@reqBody(validator?: any)

Inject req.body.

• validator Optional. A class with decorators of class-validator. tachijs will validate req.body with it and transform req.body into the validator class. If validator is not given but the parameter has a class validator as its param type, tachijs will use it via reflect-metadata.

import { controller, httpPost, reqBody } from 'tachijs'

@controller('/post')
class PostController {
  @httpPost('/')
  // Identically same to `create(@reqBody(PostDTO) post: PostDTO)`
  create(@reqBody() post: PostDTO) {
    ...
  }
}

@reqParams(paramName?: string)

Inject req.params or its property.

• paramName If it is given, req.params[paramName] will be injected.

@reqQuery(paramName?: string)

Inject req.query or its property.

• paramName If it is given, req.query[paramName] will be injected.

@reqHeaders(paramName?: string)

Inject req.headers or its property.

• paramName If it is given, req.headers[paramName] will be injected.

@reqCookies(paramName?: string)

Inject req.cookies or its property.

• paramName If it is given, req.cookies[paramName] will be injected.

@reqSignedCookies(paramName?: string)

Inject req.signedCookies or its property.

• paramName If it is given, req.signedCookies[paramName] will be injected.

@cookieSetter()

Inject res.cookie method to set cookie.

@cookieClearer()

Inject res.clearCookie method to clear cookie.

@reqSession(paramName?: string)

Inject req.session.

BaseController

A base for controller which have lots of helper methods for returning built-in results. Also, it allows another way to access properties of req, res and inject without any decorators.

• #context tachijs will set req, res and inject method to this property. So, when unit testing, it is not defined.
  • #context.req Raw express request instance
  • #context.req Raw express response instance
  • #inject<S>(key: string): S A method to access a registered service by the given key. It is almost same to @inject decorator. (@inject<ServiceTypes.SomeService> someService: SomeService => const someService = this.inject<SomeService>(ServiceTypes.SomeService))
• #end(data: any, encoding?: string, status?: number): EndResult
• #json(data: any, status?: number): JSONResult
• #redirect(location: string, status?: number): RedirectResult
• #render(view: string, locals?: any, callback?: RenderResultCallback, status?: number): RenderResult
• #sendFile(filePath: string, options?: any, callback?: SendFileResultCallback, status?: number): SendFileResult
• #send(data: any, status?: number): SendResult
• #sendStatus(status: number): SendStatusResult

Results

BaseResult

All of result classes must be extended from BaseResult because tachijs can recognize results by instanceof BaseResult.

It has only one abstract method which must be defined by descendant classes.

• execute(req: express.Request, res: express.Response, next: express.NextFunction): Promise<any> tachijs will use this method to finalize response.

new EndResult(data: any, encoding?: string, status: number = 200)

tachijs will finalize response with res.status(status).end(data, encoding).

new JSONResult(data: any, status: number = 200)

tachijs will finalize response with res.status(status).json(data).

new NextResult(error?: any)

tachijs will finalize response with next(error).

new RedirectResult(location: string, status?: number)

tachijs will finalize response with res.redirect(location) (or res.redirect(status, location) if the status is given).

new RenderResult(view: string, locals?: any, callback?: RenderResultCallback, status: number = 200)

tachijs will finalize response with res.status(status).render(view, locals, (error, html) => callback(error, html, req, res, next))

type RenderResultCallback = (
  error: Error | null,
  html: string | null,
  req: express.Request,
  res: express.Response,
  next: express.NextFunction
) => void

new SendFileResult(filePath: string, options: any, callback?: SendFileResultCallback, status: number = 200)

tachijs will finalize response with res.status(status).sendFile(filePath, options, (error) => callback(error, req, res, next))

type SendFileResultCallback = (
  error: Error | null,
  req: express.Request,
  res: express.Response,
  next: express.NextFunction
) => void

new SendResult(data: any, status: number = 200)

tachijs will finalize response with res.status(status).send(data).

new SendStatusResult(status: number)

tachijs will finalize response with res.sendStatus(status).

@inject(key: string)

Inject a registered service in container by the given key.

class Injector

new Injector<C>(container: C)

Instantiate an injector with container

#instantiate(Constructor: any): any

Instantiate a service constructor. If the constructor has injected services, this method instantiate and inject them by #inject method.

#inject<S = any>(key: string): S

Instantiate a service by a key from Container. If there is no service for the given key, it will throws an error.

License

MIT © Junyoung Choi

boost-releases's Issues

Minimize to system tray (windows)

Is there a way to minimize Boostnote to the system tray on Windows when I close the [X} button (or the minimize button) in order to leave it running but not on the task bar but the system tray. If not, that would be a wonderful feature to have.

Greetings and keep up the good work

In Windows version, Alt+Tab toggles menu bar

In Windows version of Boostnote, when I press Alt+Tab to switch between app, Boostnote also hides/shows the menu bar.

I would expect it to show/hide the menu bar when single Alt pressed and then released, but not on Alt+Tab.

This is not a functionality issue, but an annoyance, since Alt+Tab is a very common action in Windows.

32-bits Debian Support

We will really appreciate it if you release 32 bits versions. I saw the application on a friend's computer and I love it. Please can you release the support for 32 bits (I am currently using Windows and Linux) both with a 32 bits architecture.

Replace background image on http://b00st.io/ with smaller version

The background image currently is a 2.3mb PNG file - I'd suggest converting it to a smaller jpg instead...

Please go https://github.com/BoostIO/Boostnote/issues to create a new issue.

This repository is only for distributing releases.
Please click here to create a new issue.

Why is there 2 apps and 3 download locations, which one do I use?

There's 3 pages to download Boostnote. Which one is a person supposed to use, to get the latest version and why are two being worked on at the same time?

Is it this one: https://github.com/BoostIO/BoostNote.next/releases
This one: https://github.com/BoostIO/boost-releases/releases
Or this one (Download Linux App): https://boostnote.io/

Please make this a bit less confusing...

EDIT: I guess the first one?

Still very confusing...

Downloadable is not working

I downloaded one .dmg package(v0.16.1) from here and my Mac wouldn't allow me to run it:

“Boostnote” can’t be opened because Apple cannot check it for malicious software. This software needs to be updated. Contact the developer for more information.

Why is that? And apparently, this one is different from the one I download from boostnote.io, this one is larger. Shouldn't they be the same (always up-to-date)?

how to install boostnote in raspberry pi4

how to install boostnote in raspberry pi4

How do I disable markdownlint?

After the upgrade i see multiple warnings about markdown which I don't want and find it really annoying. I cannot find an option in preferences to disable this linting. Please help me.

Cant Edit anymore

After latest Update 0.12.1 I can only edit the content of a note by using the "Toggle Mode" Icon.

No matter what I select in Preferences. Normally I use "Edit on right click" but also "Edit on double click" both are currently not working. Everytime I want to edit a note I need to toggle through the modes to ge tto the full markdown editor :(

Any Ideas?

Checksums for downloads?

Are there no checksums for the downloaded versions? This is especially important for windows.

Feature Request: Add Inline Images

I really love Boostnote, it's a indispensable tool on my workflow.
But, there's something that I really miss: inline images support (from PC and clipboard content)
Used to use Quiver (Boostnote alternative for macOS) and it was one of the most killer features.
Hope you read it and fill my request.
Thank you for develop such a incredible productivity tool.
God bless you all!
Cheers from Brazil!

PDF出力の際に2P目以降ホワイトアウトします

command+PでPDF出力すると2P目以降ホワイトアウト（真っ白になる）してすごく困ってます。

markdown TOC can't jump to title V0.11.17

I use BoostnoteV0.11.15 before，It can jump to title from TOC, But when I update to V0.11.17, It can't jump any more.

Only me or everyone?

platform:windows10x64 BoostnoteV0.11.17

thanks!

Share Icon

Why I cant share a public link of my notes ?
the Cursor changes to a "cancel" icon, when I put the cursor on top of the Share button in the upper right corner.

Boost Application (Windows 7) started all of a sudden with "No Storage Mount"

I had created a Boost Notes data folder at : D:\BoostCoding which has the boostnote.json and notes folder with all notes ending in .cson intact . I had created many notes with some as plain text and some as Markdown. I have lost access to notes from Boost App. See attached issue images.

Seach text in Snnipet code with multi tab won't locate correctly

When search a text in notes, the snnipet only go to first tab, not the tab which the text locates.

Consuming 100% of CPU

Hello, noticing this kind of behaviour for the 3rd time for the last week. My notes are just a few (~40 notes)

• OS: macOS 10.15.3 19D76 x86_64
• Host: MacBookPro14,1
• Kernel: 19.3.0
• CPU: Intel i5-7360U (4) @ 2.30GHz
• GPU: Intel Iris Plus Graphics 640
• Memory: 6125MiB / 8192MiB

I'm attaching process sample during CPU clog and some screenshots.

Sample of Boostnote.txt

Editor styling not working after latest update

Today a new update was pushed. After the install the editor themes don't work anymore. I was using a dark them. But now the editor part is white with no code highlighting. Only the default editor has code highlighting. Hope someone can provide a fix.

Thanks to all the people who al contributing there precious time creating this wonderful app!

More languages?

I really like this software, but can support more languages? Like Chinese?

The Loss of Hours worth of Notes

Boostnote is an amazing app, I love the design and really the best notetaking app out there, however this recent update has made it feel clunky and has made me downgrade to previous releases of Boostnote. First off, for some reason when I use offline note taking I still run into the issue of when i close the app it doesn't save all of my notes (at least half the time). I had this same issue when storing my notes online, so I decided to move my notes to being offline since I figured that it may something to do with that, however that hasn't been the case, I recently lost easily 2-3 hours worth of notes for no apparent reason. Regardless I love the app and I think you guys are doing an outstanding job. :) I look forward to what else you guys decide to add.

0.11.11 (2018/11/16) version error

When the code segment and plain text are not wrapped, the code segment will repeat or display the error directly. Such as:

Code block in 0.11.11 is rendered repeatedly, ok in 0.11.10.

When i have following

some text
~~~java
int a = 1
~~~

1. some title
~~~kotlin
val a = 1
~~~

They are rendered correctly in 0.11.10, but in 0.11.11, the code block is rendered repeatedly. Replacing ~~~ with ``` gives same result.

Code block theme does not work after latest update

Version: 0.11.17
Version prior to update: 0.11.15
OS: Windows 10

After update to 0.11.17, code block theme stopped working. I am using the default theme for editor and overall UI, therefore found no issue with them. However, I saw, editor theme issue is already opened.

Analysis:
I found that there is code change in main.js after v0.11.15 at following code block. A new theme check has been added. Theme path hold the full path of theme path, instead of relative path. Therefore, when it gets added to appPath, a wrong path location is formed. Therefore, code block theme does not reflect.

            key: 'GetCodeThemeLink',
	    value: function GetCodeThemeLink(name) {
	      var theme = _consts2.default.THEMES.find(function (theme) {
	        return theme.name === name;
	      });
	      if (theme) {
	        return appPath + '/' + theme.path;
	      } else {
	        return appPath + '/node_modules/codemirror/theme/elegant.css';
	      }
	    }

Fix:
Returned value inside theme check should return the theme.path as shown below:

              ...
	      if (theme) {
	        return theme.path;
	      } else {
              ...

Can not display images

Boost releases v0.11.5 can not display image ???

require windows portable version

Update website with the correct version, currently 0.1.2

The website version of boost note is 0.1.2, which might confuse new people like it did me lol, just thought I'd let you know that there might be others out there with the completely wrong version without knowing it.

via boostnote.io

Why the release on the website is not the latest.

Missing so many features.

There is no scroll bar on the "black-left-panel/column" listing the "storage locations"

Since upgrading to the newest version (0.15.0), The app in my mac lost the scroll bar on the "black-left-panel/column" that contains the list of the "storage locations".
The scrolling on the list is very important, so, please, fix this issue and put back the scroll bar for the mac version. Scroll bars for the other three panels (notes, raw text, formatted text) just work fine!, but no the storages one.
Many thanks.

Boostnote .deb package changes filesystem permissions to 775

The boostnote .deb file sets various filesystem permissions to 775. This is a big security problem.

As noted when you install the boostnote-bin AUR package:

(1/1) installing boostnote-bin [############################################################################] 100% 
warning: directory permissions differ on /usr/ filesystem: 755 package: 775 
warning: directory permissions differ on /usr/share/ filesystem: 755 package: 775
warning: directory permissions differ on /usr/bin/ filesystem: 755 package: 775 
warning: directory permissions differ on /usr/share/doc/ filesystem: 755 package: 775 
warning: directory permissions differ on /usr/share/pixmaps/ filesystem: 755 package: 775 
warning: directory permissions differ on /usr/share/applications/ filesystem: 755 package: 775

This is probably caused by a huge bug in npm: npm/npm#9359

Mermaid graphs size

Hi. First of all thank you for super cool notebook and that you add support for mermaid charts. But one thing doesn't let me use their full power.

If I generate small simple graphs they look OK or even too big (letters, squares). But if I need more nodes and leafs its veiwport stay fixed, but font-size and squares start decreasing and at some point it is unable to read text in the blocks. From the user perspective It would be better to have fixed font size and resize automatically viewport to fit the graph content.

Tag <kbd> broke

Boostnote 0.11.4

download

nvm

Can't re-install after upgrade to Ubuntu 20.10

After upgrade to Ubuntu 20.10, Boostnote disappeared from the system. On attempting to reinstall the latest .deb package, found that now it has an unmet dependency: gvfs-bin This package has been removed because it's deprecated so it won't be re-added.

Error in linux 64 deb file

> sudo dpkg -i boostnote_0.9.0_amd64.deb 

dpkg-deb: error: archive 'boostnote_0.9.0_amd64.deb' has premature member 'control.tar.xz' before 'control.tar.gz', giving up
dpkg: error processing archive boostnote_0.9.0_amd64.deb (--install):
 subprocess dpkg-deb --control returned error exit status 2
Errors were encountered while processing:
 boostnote_0.9.0_amd64.deb