Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/gengjiawen/blitzjs-demo
https://github.com/gengjiawen/blitzjs-demo
Last synced: 16 days ago
JSON representation
- Host: GitHub
- URL: https://github.com/gengjiawen/blitzjs-demo
- Owner: gengjiawen
- Created: 2024-02-21T13:38:16.000Z (10 months ago)
- Default Branch: master
- Last Pushed: 2024-04-12T03:05:47.000Z (9 months ago)
- Last Synced: 2024-12-08T18:58:27.850Z (21 days ago)
- Language: TypeScript
- Homepage: https://blitzjs-demo-eta.vercel.app
- Size: 563 KB
- Stars: 0
- Watchers: 2
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
[](https://blitzjs.com)
This is a [Blitz.js](https://github.com/blitz-js/blitz) app.
# ****name****
## Getting Started
Run your app in the development mode.
```
blitz dev
```
Open [http://localhost:3000](http://localhost:3000) with your browser to see the result.
## Environment Variables
Ensure the `.env.local` file has required environment variables:
```
DATABASE_URL=postgresql://@localhost:5432/blitzjs-demo
```
Ensure the `.env.test.local` file has required environment variables:
```
DATABASE_URL=postgresql://@localhost:5432/blitzjs-demo_test
```
## Tests
Runs your tests using Jest.
```
yarn test
```
Blitz comes with a test setup using [Vitest](https://vitest.dev/) and [react-testing-library](https://testing-library.com/).
## Commands
Blitz comes with a powerful CLI that is designed to make development easy and fast. You can install it with `npm i -g blitz`
```
blitz [COMMAND]
dev Start a development server
build Create a production build
start Start a production server
export Export your Blitz app as a static application
prisma Run prisma commands
generate Generate new files for your Blitz project
console Run the Blitz console REPL
install Install a recipe
help Display help for blitz
test Run project tests
```
You can read more about it on the [CLI Overview](https://blitzjs.com/docs/cli-overview) documentation.
## What's included?
Here is the starting structure of your app.
```
blitzjs-demo
├── README.md
├── db
│ ├── index.ts
│ └── schema.prisma
├── integrations
├── mailers
│ └── forgotPasswordMailer.ts
├── next-env.d.ts
├── next.config.js
├── package.json
├── public
│ └── favicon.ico
├── src
│ ├── app
│ │ ├── (auth)
│ │ │ ├── components
│ │ │ │ ├── ForgotPasswordForm.tsx
│ │ │ │ ├── LoginForm.tsx
│ │ │ │ ├── LogoutButton.tsx
│ │ │ │ ├── ResetPasswordForm.tsx
│ │ │ │ └── SignupForm.tsx
│ │ │ ├── forgot-password
│ │ │ │ └── page.tsx
│ │ │ ├── layout.tsx
│ │ │ ├── login
│ │ │ │ └── page.tsx
│ │ │ ├── mutations
│ │ │ │ ├── changePassword.ts
│ │ │ │ ├── forgotPassword.test.ts
│ │ │ │ ├── forgotPassword.ts
│ │ │ │ ├── login.ts
│ │ │ │ ├── logout.ts
│ │ │ │ ├── resetPassword.test.ts
│ │ │ │ ├── resetPassword.ts
│ │ │ │ └── signup.ts
│ │ │ ├── reset-password
│ │ │ │ └── page.tsx
│ │ │ ├── signup
│ │ │ │ └── page.tsx
│ │ │ └── validations.ts
│ │ ├── blitz-auth-config.ts
│ │ ├── blitz-client.ts
│ │ ├── blitz-server.ts
│ │ ├── components
│ │ │ ├── Form.tsx
│ │ │ └── LabeledTextField.tsx
│ │ ├── error.tsx
│ │ ├── layout.tsx
│ │ ├── loading.tsx
│ │ ├── page.tsx
│ │ ├── styles
│ │ │ ├── Home.module.css
│ │ │ └── globals.css
│ │ └── users
│ │ ├── hooks
│ │ │ └── useCurrentUser.ts
│ │ └── queries
│ │ └── getCurrentUser.ts
│ └── pages
│ └── api
│ └── rpc
│ └── [[...blitz]].ts
├── tsconfig.json
└── types.ts
```
These files are:
- The `src/` folder is a container for most of your project. This is where you’ll put any pages or API routes.
- `db/` is where your database configuration goes. If you’re writing models or checking migrations, this is where to go.
- `public/` is a folder where you will put any static assets. If you have images, files, or videos which you want to use in your app, this is where to put them.
- `integrations/` is a folder to put all third-party integrations like with Stripe, Sentry, etc.
- `test/` is a folder where you can put test utilities and integration tests.
- `package.json` contains information about your dependencies and devDependencies. If you’re using a tool like `npm` or `yarn`, you won’t have to worry about this much.
- `tsconfig.json` is our recommended setup for TypeScript.
- `.babel.config.js`, `.eslintrc.js`, `.env`, etc. ("dotfiles") are configuration files for various bits of JavaScript tooling.
- `blitz.config.ts` is for advanced custom configuration of Blitz. [Here you can learn how to use it](https://blitzjs.com/docs/blitz-config).
- `vitest.config.ts` contains config for Vitest tests. You can [customize it if needed](https://vitejs.dev/config/).
You can read more about it in the [File Structure](https://blitzjs.com/docs/file-structure) section of the documentation.
### Tools included
Blitz comes with a set of tools that corrects and formats your code, facilitating its future maintenance. You can modify their options and even uninstall them.
- **ESLint**: It lints your code: searches for bad practices and tell you about it. You can customize it via the `.eslintrc.js`, and you can install (or even write) plugins to have it the way you like it. It already comes with the [`blitz`](https://github.com/blitz-js/blitz/tree/canary/packages/eslint-config) config, but you can remove it safely. [Learn More](https://blitzjs.com/docs/eslint-config).
- **Husky**: It adds [githooks](https://git-scm.com/docs/githooks), little pieces of code that get executed when certain Git events are triggerd. For example, `pre-commit` is triggered just before a commit is created. You can see the current hooks inside `.husky/`. If are having problems commiting and pushing, check out ther [troubleshooting](https://typicode.github.io/husky/#/?id=troubleshoot) guide. [Learn More](https://blitzjs.com/docs/husky-config).
- **Prettier**: It formats your code to look the same everywhere. You can configure it via the `.prettierrc` file. The `.prettierignore` contains the files that should be ignored by Prettier; useful when you have large files or when you want to keep a custom formatting. [Learn More](https://blitzjs.com/docs/prettier-config).
## Learn more
Read the [Blitz.js Documentation](https://blitzjs.com/docs/getting-started) to learn more.
The Blitz community is warm, safe, diverse, inclusive, and fun! Feel free to reach out to us in any of our communication channels.
- [Website](https://blitzjs.com)
- [Discord](https://blitzjs.com/discord)
- [Report an issue](https://github.com/blitz-js/blitz/issues/new/choose)
- [Forum discussions](https://github.com/blitz-js/blitz/discussions)
- [How to Contribute](https://blitzjs.com/docs/contributing)
- [Sponsor or donate](https://github.com/blitz-js/blitz#sponsors-and-donations)